Hurtownia Shortcodes — Dokumentacja Panelu Administratora
Dokumentacja

Panel Administratora

Kompletny przewodnik po ustawieniach i funkcjach wtyczki Hurtownia Shortcodes. Dowiedz się jak konfigurować sklep B2B, zarządzać klientami, przedstawicielami i promocjami.

WooCommerce B2B manage_woocommerce WordPress Plugin
📋

Wstęp

Wtyczka Hurtownia Shortcodes to rozbudowany system zarządzania sklepem hurtowym B2B na platformie WordPress + WooCommerce. Panel administratora dostępny jest pod menu Hurtownia i podzielony na sekcje tematyczne.

  • Administrator WordPress (rola manage_options)
  • Kierownik sklepu WooCommerce (rola manage_woocommerce)
💡
Shortcodes Atrybuty shortcode umieszczone bezpośrednio w treści strony nadpisują ustawienia zapisane w panelu. W polach tekstowych można używać tagów HTML: <strong>, <em>, <br>.
🛒

Hurtownia — ustawienia sklepu

Siatka produktów

Konfiguracja katalogu produktów hurtowni. Shortcode: [hurt_grid]

Ustawienia ogólne

Kategoria
puste
Slug kategorii WooCommerce. Kilka po przecinku: suplementy,witaminy. Puste = wszystkie produkty
Kolumny (desktop)
4
Liczba kolumn na dużym ekranie. Tablet: 3→2, mobile: 1 (automatycznie)
Min. ilość
1
Minimalna ilość w polu quantity — przy sprzedaży w opakowaniach zbiorczych
Maks. produktów
50
Ile produktów wyświetlić łącznie na siatce
Wyszukiwarka
1
Pasek wyszukiwania nad siatką
Pokaż SKU
1
Numer SKU pod nazwą produktu na karcie
Suffix ceny
netto
Tekst za ceną: netto, brutto itp.
URL Pre-Checkout
puste
Adres strony pre-checkout dla przedstawicieli. Puste = normalny checkout dla wszystkich
Waluta
zł
Symbol waluty przy cenach: zł, PLN, €
Tekst: nudge tierowy
Jeszcze {n} szt. → {price} {currency}/szt.
Podpowiedź do kolejnego progu cenowego. Zmienne: {n}, {price}, {currency}

Zakładki produktu

Kreator zakładek wyświetlanych na stronie produktu. Drag & drop kolejności, ikony z Heroicons, color picker, usuwanie zbędnych zakładek.

Strona logowania

GrupaPrzykładowe parametry
OgólneKolor tła strony, URL logo, rozmiar i zaokrąglenie logo
FormularzTło pól, kolor ramek, tekst etykiet, efekt focus
Przycisk logowaniaKolor tła, kolor tekstu, cień przycisku
Linki i komunikatyKolor linków, tło komunikatów informacyjnych, styl błędów

Strona główna (Landing Page)

SekcjaCo można ustawić
HeroNazwa marki, podtytuł, tytuł, punkty wyróżniające, URL zdjęcia, przypis
Przyciski i linkiTekst i URL przycisków: Zaloguj, Wniosek o dostęp, Zapytanie ofertowe, CTA
Trzy cechyIkona (emoji) i tekst dla każdej z trzech cech widocznych pod hero
Jak to działaTytuł sekcji i opisy czterech kroków procesu zakupowego
KoloryKolor główny, hover, tło Hero, tło cech, tło CTA, kolory tekstu

Kolory

Paleta bazowa (primary, accent, tło, obramowania, tekst, ceny, przyciski), kolory pre-checkout, strony produktu i pakietów.

Karta produktu — PDF

  • Wybór sekcji widocznych w PDF metodą drag & drop (zdjęcie, tytuł+SKU, cena, zakładki, krótki opis)
  • Włącz/wyłącz: SKU, kategoria, data generowania, logo, stopka
  • Upload logo wyświetlanego w nagłówku PDF
  • Podgląd karty PDF aktualizowany na żywo
📦

Produkty

Dostępność

Masowe zarządzanie stanami i cenami — bez wchodzenia w każdy produkt osobno.

KolumnaOpis
ProduktNazwa produktu z miniaturką i numerem SKU
Cena (zł)Regularna cena produktu — edytowalne pole
Cena promo (zł)Cena promocyjna. Wyczyszczenie pola usuwa promocję
StatusCheckbox "Niedostępny" — zaznaczenie oznacza produkt jako out of stock

Cennik ilościowy (progi cenowe)

Kreator indywidualnych cen przy zakupie określonej ilości (tiery). Do 3 progów cenowych per produkt.

👥

Zespół

Przedstawiciele

Lista przedstawicieli

KolumnaOpis
Imię i nazwisko / IDPełne dane. Badge ZABLOKOWANY przy zablokowanych kontach
TelefonEdytowalne pole — zmiana zapisuje się po wyjściu z pola
Ostatnie logowanieData i godzina + czas względny ("2 tygodnie temu")
LogowaniaLiczba logowań w bieżącym miesiącu — zielona jeśli > 0
Max rabat %Maksymalny rabat który ten przedstawiciel może przyznać klientowi (0–100%)
AkcjeBlokada/odblokowanie konta (kłódka) + trwałe usunięcie (kosz)

Maksymalna suma wszystkich rabatów

Globalny limit sumy wszystkich rabatów. Chroni marżę — nawet jeśli na produkt nałożone są promocje i tiery, przedstawiciel nie może łącznie przekroczyć tego progu.

⚠️
Przykład Jeśli globalny limit = 55%, a produkt ma już 45% rabatu sklepowego — przedstawiciel może dodać max 10%.

Prowizja za zastępstwo (split prowizji)

Zastępujący %
30%
Procent prowizji który otrzymuje rep faktycznie obsługujący klienta
Opiekun %
70%
Reszta trafia do właściwego opiekuna klienta. Wyliczane automatycznie

Urlopy i zastępstwa

  • Kliknij Dodaj urlop i wskaż kto jest na urlopie, kto zastępuje i w jakich datach
  • Aktywne urlopy w widoku głównym, zakończone w archiwum
  • Zastępca automatycznie otrzymuje split prowizji za zamówienia złożone w tym okresie

Opiekunowie

  • Lista wszystkich przedstawicieli z liczbą przypisanych klientów
  • Statystyka nieprzypisanych klientów
  • Masowe przypisywanie klientów — wyszukiwarka + lista + wybór opiekuna jednym kliknięciem
🏚

Klienci

Profil klienta (CRM)

Wyszukiwarka po nazwie firmy, imieniu i nazwisku, emailu. Filtrowanie po opiekunie. Szczegółowy profil z historią zamówień, tagami CRM, notatkami i eksportem CSV.

Książka adresowa klienta

ZakładkaPola
Płatnicy (rozliczeniowe)Firma, imię/nazwisko, adres, kod, miasto, kraj, telefon, email
Adresy dostawyFirma, imię/nazwisko, adres, kod, miasto, kraj
💡
Limit i kompatybilność Limit: 60 adresów per klient. Dane przechowywane jako thwma_custom_address — pełna kompatybilność z ThemeHigh Multiple Addresses. Admin edytuje adresy każdego klienta, przedstawiciel — tylko swoich klientów.

Zapytania ofertowe

Moduł aktywowany w zakładce System → Moduły.

Statusy zapytań

StatusZnaczenie
NoweZapytanie wpłynęło — czeka na obsługę
Oferta wysłanaPrzedstawiciel wycenił i wysłał ofertę klientowi
ZaakceptowaneKlient zaakceptował ofertę
OdrzuconeKlient lub administrator odrzucił zapytanie
WygasłeMinął termin ważności oferty
ZamówioneZapytanie przekształciło się w zamówienie WooCommerce

Komunikator (Chat)

RolaMożliwości
AdministratorWidzi wszystkie wątki, pisze do każdego użytkownika
PrzedstawicielWidzi wątki swoich klientów i nieprzypisanych; pisze do swoich klientów i adminów
KlientPisze do admina lub swojego opiekuna; widzi tylko własne wątki

Rejestracje

Obsługa wniosków o konto od nowych klientów. Trzy zakładki: Oczekujące, Zatwierdzone, Odrzucone. Akcje: Zatwierdź, Odrzuć, Usuń.

Email aktywacyjny

Edytor szablonu HTML wiadomości wysyłanej po zatwierdzeniu konta. Dostępne zmienne: {name}, {company}, {email}, {shop_name}, {login_url}

Grupy rabatowe

Tworzenie nazwanych grup klientów z przypisanym procentowym rabatem. Grupy działają jako jedno ze źródeł rabatu — system zawsze stosuje najwyższy z dostępnych: indywidualny, grupowy lub progowy.

Zarządzanie grupami

Nazwa grupy
Dowolna nazwa opisowa, np. Apteki premium, Klienci standardowi, Partnerzy strategiczni
Rabat (%)
Procentowy rabat od ceny regularnej. Działa jako max(rabat_indywidualny, rabat_grupowy, rabat_progowy) — nigdy nie sumuje się z pozostałymi
  • Dodaj grupę — nazwa i procent rabatu, zapis natychmiastowy
  • Edycja nazwy i procentu inline — bez przeładowania strony
  • Usunięcie grupy nie kasuje klientów — tracą tylko przypisanie do tej grupy

Przypisanie klientów do grup

Osobna zakładka Przypisanie grup z wyszukiwarką po nazwie firmy i emailu. Masowe przypisywanie — zaznacz wielu klientów i przypisz do grupy jednym kliknięciem.

KolumnaOpis
Firma / EmailDane identyfikacyjne klienta
Aktualna grupaNazwa przypisanej grupy rabatowej lub — gdy brak przypisania
Rabat indywidualnyRabat ustawiony bezpośrednio na koncie klienta
Efektywny rabatNajwyższy z dostępnych — ten który faktycznie obowiązuje przy zamówieniu
PrzypiszDropdown wyboru grupy — zmiana działa natychmiastowo bez zapisu formularza
💡
Priorytet rabatów System stosuje max(indywidualny, grupowy, progowy). Klient zawsze dostaje najkorzystniejszy rabat — bez ryzyka przypadkowego obniżenia zniżki przy zmianie grupy.

🔥 Klienci przy progu

Operacyjna lista klientów posortowana według odległości od następnego progu rabatowego. Narzędzie pracy repa: od razu widzi, do kogo zadzwonić żeby domknąć obrót przed końcem okresu i podbić rabat klienta na kolejny miesiąc.

KolumnaOpis
FirmaNazwa klienta z linkiem do profilu CRM
Obrót bieżącySuma netto z bieżącego okna czasowego (włącznie z aktualnym, otwartym miesiącem)
PostępPasek wizualizujący obrót względem następnego progu
Brakuje do proguKwota netto dzieląca klienta od następnego rabatu — konkretny argument do rozmowy sprzedażowej
Aktualny rabatRabat progowy obowiązujący w tym miesiącu (przyznany na podstawie poprzedniego okresu)
  • Filtr po statusie: Osiągnięty próg / Blisko progu / Bez obrotu
  • Filtr po opiekunie — rep widzi domyślnie tylko swoich klientów
  • Filtr procentowy — domyślnie klienci w zasięgu 20% od kolejnego progu (configurowalny)
  • Wyszukiwarka po nazwie firmy i paginacja co 50 rekordów

Ten sam widok dostępny jest jako shortcode [hurt_turnover_watch] na stronach frontendowych (np. dedykowany panel repa lub Moje konto).

📈 Rabaty progowe — konfiguracja

Automatyczny system rabatów oparty na skumulowanym obrocie klienta z wybranego okresu. Co miesiąc system wylicza obrót każdego klienta z ostatnich N miesięcy i przyznaje rabat na kolejny miesiąc — bez ręcznej pracy ze strony repa ani klienta. Wymaga planu Business (w cenie) lub addonu +149 zł/mc.

Okres liczenia obrotu

Okres liczenia obrotu
1 miesiąc
Okno czasowe agregacji obrotu. Jeden parametr globalny dla wszystkich progów. Dostępne opcje:
  • 1 miesiąc — poprzedni miesiąc. Dla branż z równomierną sprzedażą (FMCG, suplementy)
  • 3 miesiące — ostatni kwartał. Wygładza krótkoterminową sezonowość
  • 6 miesięcy — ostatnie półrocze. Dla branż sezonowych (ogrodnicza, budowlana)
  • 12 miesięcy — ostatni rok. Dla branż z rzadkimi dużymi zamówieniami (HoReCa, przemysłowa)
💡
Nowi klienci Jeśli klient ma 2 miesiące historii a okno ustawione na 6 miesięcy — system sumuje dostępne 2 miesiące. Krótka historia zakupów nie blokuje przyznania rabatu.

Tabela progów

PoleOpis
Obrót od (zł netto)Minimalna suma netto z wybranego okresu aby próg się aktywował
Rabat (%)Procentowy rabat obowiązujący przez cały następny miesiąc

Liczba progów jest nieograniczona. System stosuje zawsze najwyższy osiągnięty próg. Przykład konfiguracji: 10 000 zł → 3%  |  25 000 zł → 5%  |  50 000 zł → 8%  |  100 000 zł → 12%.

Karty statusowe

KartaCo pokazuje
Ostatnie przeliczenieData i godzina ostatniego automatycznego przeliczenia rabatów
Klienci z rabatemLiczba klientów którzy aktualnie mają przyznany rabat progowy (> 0%)
Klienci sprawdzeniŁączna liczba klientów sprawdzonych przy ostatnim przeliczeniu
Aktywne oknoAktualnie skonfigurowany okres liczenia (1/3/6/12 mies.)

Przycisk Uruchom teraz wymusza natychmiastowe przeliczenie poza normalnym harmonogramem — przydatny po zmianie progów lub okna. System uruchamia przeliczenie automatycznie przy pierwszym wejściu na stronę w nowym miesiącu (lazy trigger — bez crona).

Widok klienta — Moje konto

Klient widzi swój status rabatowy w zakładce Moje konto → Rabaty progowe. Pełna informacja bez konieczności dzwonienia do repa.

ElementCo pokazuje
Hero — aktualny rabatProcent rabatu obowiązującego w tym miesiącu (zielony gdy > 0%). Podpis: Za obrót styczeń – marzec 2026: 34 500 zł
Obrót z okresuSuma netto z bieżącego okna z etykietą okresu, np. z ostatnich 3 miesięcy (styczeń – marzec 2026)
Pasek postępuWizualizacja obrotu względem następnego progu
Callout "brakuje"Brakuje X zł do Y% — gdy klient nie osiągnął jeszcze najwyższego progu
Tabela progówWszystkie skonfigurowane progi z oznaczeniem osiągniętych (✓)

Mechanizm przeliczania

1
Klient składa zamówienieObrót netto (bez dostawy) zapisywany jest do wewnętrznej tabeli {prefix}hurt_monthly_turnover per miesiąc. Anulowane i zwrócone zamówienia są automatycznie odejmowane.
2
Początek nowego miesiącaPrzy pierwszym wejściu na stronę system wykrywa nowy miesiąc i uruchamia przeliczenie (lazy trigger — bez crona).
3
Agregacja obrotu w oknieDla każdego klienta sumowany jest obrót zamówień zakończonych z ostatnich N miesięcy (z wyłączeniem bieżącego, wciąż otwartego miesiąca).
4
Przyznanie rabatu i zapis w user metaKlient otrzymuje rabat najwyższego osiągniętego progu. Zapisywane: _hurt_turnover_discount, _hurt_turnover_month, _hurt_turnover_window, _hurt_turnover_window_label.

Backfill historii zamówień

Przy pierwszej aktywacji modułu system automatycznie importuje historię zamówień z ostatnich 12 miesięcy do tabeli obrotów. Moduł działa poprawnie od pierwszego dnia — bez okresu "rozgrzewki". Backfill uruchamia się jednorazowo w tle przy wejściu do panelu admina.

💼

Moduł Księgowego

Dedykowany panel dla roli hurt_ksiegowy. Obsługuje cykl życia płatności odroczonych — od wystawienia zamówienia przez blokadę przy zaległościach, aż po zatwierdzenie wpłaty i procedurę wyjątków na wniosek przedstawiciela.

ℹ️
Rola hurt_ksiegowy Użytkownik z tą rolą widzi wyłącznie zakładkę Księgowość — bez dostępu do reszty panelu Hurtownia. Administrator przyznaje rolę w profilu użytkownika WordPress.

Panel rozliczeń

Tabela wszystkich zamówień z płatnością odroczoną (7 / 14 / 21 / 30 dni), posortowanych domyślnie od najbliższego terminu wymagalności.

Statusy rozliczeń

StatusZnaczenie
OczekujeTermin jeszcze nie minął — klient może zamawiać normalnie, w tym na termin
PrzeterminowaneTermin płatności minął — aktywna blokada terminu dla klienta
OpłaconeKsięgowy zatwierdził wpłatę — blokada zdjęta
WyjątekTymczasowe zniesienie blokady na wniosek przedstawiciela — na jedno zamówienie

Jak działa blokada terminu

⚠️
Zasada działania blokady Przy aktywnej blokadzie opcja płatności odroczonej („na termin") znika z formularza zamówienia. Klient może złożyć zamówienie wyłącznie z natychmiastową płatnością kartą lub przelewem online (Stripe / Przelewy24). Blokada pozostaje aktywna dopóki każde przeterminowane zamówienie nie zostanie zatwierdzone jako opłacone przez księgowego.

Przebieg zatwierdzenia wpłaty

1
Klient reguluje zaległośćPrzelew, gotówka lub karta — poza systemem WooCommerce
2
Księgowy klika „Zatwierdź zapłatę"Przy danym zamówieniu w panelu rozliczeń
3
System oznacza zamówienie jako OpłaconeMetapole _hurt_payment_settled → 1
4
Automatyczna weryfikacja blokadyJeśli klient nie ma już innych przeterminowanych zamówień — opcja „na termin" wraca do formularza

Wyjątki płatności — wniosek przedstawiciela

Przedstawiciel handlowy może poprosić księgowego o tymczasowe zniesienie blokady dla swojego klienta. Mechanizm zachowuje pełną kontrolę — decyzja zawsze należy do księgowego.

Ścieżka wyjątku

1
Rep otwiera profil klienta w CRMWidzi aktywną blokadę i przycisk „Poproś o wyjątek płatności"
2
Wpisuje uzasadnienie (wymagane)Treść trafia do widoku księgowego. Wniosek bez uzasadnienia nie może zostać złożony
3
Wniosek pojawia się w panelu księgowegoZ imieniem repa, datą i treścią uzasadnienia
4
Księgowy klika „Przyznaj wyjątek"Klient natychmiast odzyskuje opcję „na termin" dla jednego zamówienia. Metapole: _hurt_payment_exception → 1
5
Wyjątek wygasa po złożeniu zamówieniaBlokada wraca automatycznie — zaległa faktura nadal wymaga zatwierdzenia przez księgowego

Filtr przeterminowanych

Osobna zakładka z widokiem wyłącznie zaległych zamówień. Kolumny sortowalne po dacie wymagalności i kwocie. Szybki podgląd: ile dni po terminie, łączna kwota zaległości per klient. Eksport do CSV jednym kliknięciem.

📢

Promocje

Banery i popupy

TypKto widziZastosowanie
KlienckiZalogowany klientPromocje, informacje dla klientów
SystemowyPrzedstawicielWewnętrzne komunikaty dla zespołu

Dla każdego banera: rich text editor, kolor tła/tekstu, targetowanie po opiekunie lub tagach CRM, daty od/do, drag & drop kolejności.

Program lojalnościowy — Kapsułki

Ikona programu
12 opcji: kapsułka, gwiazdka, serce, trofeum, prezent, błyskawica, ogień, iskierki, moneta, puzzle, korona, rakieta
Liczba kapsułek
Ile punktów trzeba zebrać (komplet)
Min. kwota zamówienia
Kwota netto od której nalicza się kapsułka (w zł)
Rabat po komplecie
Procentowy rabat po zebraniu kompletu kapsułek
Tekst nudge'u
Komunikat podczas zbierania. Zmienne: {zebrane}, {ilość}, {rabat}
Kolory kapsułek
Kolor pełnej, pustej i efektu blasku (glow) przy zebraniu kompletu

Pakiety produktów

  • Tworzenie zestawów produktów ze specjalną ceną pakietową
  • Filtry produktów po kategorii przy tworzeniu zestawu
  • Drag & drop kolejności pakietów
  • Toggle aktywny/nieaktywny bez usuwania
📊

Statystyki

  • Filtr zakresu dat (Od / Do) i szybki wybór okresu (Ten miesiąc, Poprzedni miesiąc, Ten rok)
  • Filtr statusu zamówień (Zrealizowane / W realizacji / Wstrzymane / Anulowane / Zwrócone)
  • Karty sumaryczne: łączna liczba zamówień, wartość sprzedaży, średnia wartość, liczba klientów
  • Tabela zamówień: numer, data, klient, opiekun, produkty, wartość, status
  • Eksport przefiltrowanej tabeli do pliku CSV
📈

Raporty

Raporty aktywności przedstawicieli

Typy aktywności: Telefon, Spotkanie, Zamówienie poza systemem, Oferta, Nowy kontakt, Reklamacja. Każdy raport: typ, data, powiązanie z klientem CRM lub prospektem, kwota, notatki.

📍 Lokalizacja GPS — konfiguracja retencji

Panel konfiguracji modułu Lokalizacja raportów dostępny jest w zakładce Raporty w panelu admina — widoczny wyłącznie gdy toggle GPS jest włączony w System → Moduły. Moduł GPS nie aktywuje się bez wcześniejszego ustawienia okresu retencji — zabezpieczenie RODO.

Okres retencji (dni)
brak
Liczba dni przechowywania danych lokalizacyjnych (7–365). Brak wartości = moduł nieaktywny mimo włączonego toggle. Po zapisaniu okresu moduł staje się aktywny — rep widzi GPS status w formularzu raportu.
  • Ostatnie czyszczenie — data i godzina, liczba usuniętych wpisów
  • Następne automatyczne czyszczenie — WP Cron uruchamia się codziennie o północy
  • Przycisk Wyczyść teraz — usuwa dane lokalizacyjne ze wszystkich raportów starszych niż ustawiony okres
  • Przycisk Wyczyść całą historię GPS — usuwa wszystkie dane lokalizacyjne niezależnie od daty (nieodwracalne)
⚠️
Odpowiedzialność RODO i prawa pracy Dane lokalizacyjne są zbierane i przechowywane wyłącznie na serwerze klienta. Administrator odpowiada za poinformowanie pracowników i ustalenie właściwej podstawy prawnej zgodnie z przepisami prawa pracy dotyczącymi monitoringu. Wtyczka zapewnia techniczne narzędzie retencji — nie zastępuje obowiązków prawnych administratora danych.

Prospekty — pipeline sprzedażowy

Baza potencjalnych klientów w procesie pozyskiwania. Dane prospektu: nazwa firmy, etap pipeline, osoba kontaktowa, notatki, historia kontaktów.

📱

Aplikacja mobilna (PWA)

Konfiguracja progresywnej aplikacji webowej dla przedstawicieli handlowych. Rep instaluje aplikację bezpośrednio na telefonie (Android / iPhone).

Pełna nazwa aplikacji
Wyświetlana przy instalacji i w ustawieniach systemu
Skrócona nazwa
max 12 znaków
Wyświetlana pod ikoną na ekranie głównym telefonu
Ikona 192×192 px
Upload z Media WordPress
Ikona 512×512 px
Upload z Media WordPress
Przekierowanie po zalogowaniu — rep
Strona startowa dla przedstawiciela po zalogowaniu w aplikacji
Przekierowanie po zalogowaniu — klient
Strona startowa dla klienta po zalogowaniu
Przekierowanie po wylogowaniu
Strona wyświetlana po wylogowaniu z aplikacji
⚙️

System — Moduły

Toggle włącz/wyłącz per moduł (AJAX, bez przeładowania). Wyłączony moduł nie ładuje się — zerowy wpływ na wydajność.

ModułOpisDomyślnie
🏠 Landing pageStrona powitalna hurtowni [hurt_landing] z CTA do logowania i rejestracjiWłączony
📄 Karta produktu PDFGenerowanie i pobieranie kart produktowych w PDF z poziomu strony produktuWłączony
📩 Zapytania ofertoweFormularz zapytań ofertowych dla nowych klientów. Negocjacja cen, konwersja na zamówienieWyłączony
📈 Rabaty progoweAutomatyczne rabaty od skumulowanego obrotu. Wymaga planu Business lub aktywnego addonuWyłączony
📍 Lokalizacja raportówPobiera lokalizację GPS telefonu przy zapisie raportu aktywności repa. Link do Google Maps w tabeli raportów. Wymaga skonfigurowania okresu retencji (7–365 dni) przed aktywacją — w zakładce Raporty w panelu admina. Przed włączeniem wymagane poinformowanie pracowników zgodnie z przepisami prawa pracy. Wymaga planu PRO.Wyłączony
🗺️ Planowanie trasyShortcode [hurt_planner] — rep zaznacza klientów, układa kolejność przystanków i otwiera optymalną trasę w Google Maps. Filtr Moi / Wszyscy klienci, drag & drop na desktopie, strzałki ↑↓ na telefonie. Wymaga planu Business lub addonu à la carte.Włączony
⚠️
Po zmianie stanu modułu należy przeładować stronę panelu, aby zmiany były widoczne w menu i interfejsie.
🔑

Licencja

Panel aktywacji klucza licencyjnego. Wprowadź klucz otrzymany po zakupie i kliknij Aktywuj. Status licencji weryfikowany jest z serwerem licencjonowania.

ℹ️
Aktywna licencja jest wymagana do pobierania automatycznych aktualizacji wtyczki.
🔧

Lista shortcodów

Wszystkie shortcody wstawia się w treści strony WordPress (edytor blokowy lub klasyczny). Każdy shortcode działa tylko dla odpowiedniej roli — nieuprawnionym użytkownikom nie renderuje niczego lub wyświetla komunikat "Brak dostępu".

💡
Jedna strona = jeden shortcode Utwórz dedykowaną stronę WordPress dla każdego shortcode'u poniżej, wklej kod i ustaw odpowiednie uprawnienia dostępu do strony.

Starter — wszystkie plany

ShortcodeProponowana stronaKto widziCo robi
[hurt_landing]/hurtownia/Wszyscy (niezalogowani)Strona powitalna hurtowni. Hero, 3 cechy, "Jak to działa", CTA do logowania i rejestracji.
[hurt_rejestracja]/rejestracja/Wszyscy (niezalogowani)Publiczny formularz rejestracji B2B z polem NIP. Konto wymaga zatwierdzenia przez admina.
[hurt_grid]/katalog/Zalogowany klient / repSiatka produktów B2B z wyszukiwarką, filtrami, koszykiem AJAX, tierami cenowymi i kapsułkami.
[hurt_checkout]/zamow/Przedstawiciel (shop_manager)Pre-checkout dla przedstawicieli — wybór klienta (Moi / Wszyscy), złożenie zamówienia w imieniu klienta.
[hurt_product]Szablon strony produktu WooCommerceZalogowany klient / repKarta produktu z zakładkami, przyciskiem PDF i tierami cenowymi.
[hurt_dodaj_klienta]/dodaj-klienta/Przedstawiciel (shop_manager)Formularz dodawania nowego klienta przez repa. Wyszukuje dane z GUS po NIP.
[hurt_klienci]/moi-klienci/Przedstawiciel / adminPanel CRM klientów. Rep widzi swoich klientów, admin widzi wszystkich.
[hurt_chat]/komunikator/Zalogowany użytkownikWbudowany komunikator między klientami, repami i adminem.
[hurt_chat_badge url="/komunikator/"]Nagłówek / dowolna stronaZalogowany użytkownikPływająca ikona 💬 z licznikiem nieprzeczytanych wiadomości.
[ah_offcanvas_menu]Widget / nagłówekWszyscyWysuwane menu boczne z hamburgerem, przyciskiem koszyka i panelem użytkownika.

Pro i wyżej

ShortcodeProponowana stronaKto widziCo robi
[hurt_moje_wyniki]/moje-wyniki/Przedstawiciel (shop_manager)Dashboard statystyk sprzedaży repa — obroty, liczba zamówień, ranking klientów, wykresy.
[hurt_raport]/raporty/Przedstawiciel / adminPanel raportowania aktywności i pipeline prospektów.
[hurt_tasks]/zadania/Przedstawiciel / adminLista zadań z priorytetami i statusami.
[hurt_dashboard_prezes]/dashboard/Admin + lista emailiWidok zarządczy — rankingi repów, sprzedaż, aktywność, pipeline.

Business i wyżej

ShortcodeProponowana stronaKto widziCo robi
[hurt_ksiegowy]/ksiegowosc/Rola hurt_ksiegowy / adminPanel rozliczeń płatności odroczonych. Zatwierdzanie wpłat, filtr przeterminowanych, obsługa wniosków o wyjątek.
[hurt_planner]/planowanie-trasy/Przedstawiciel (shop_manager) / adminPlaner trasy do klientów. Toggle Moi / Wszyscy klienci, wyszukiwarka, panel trasy z drag & drop (desktop) i strzałkami ↑↓ (mobile), punkt startowy z GPS lub adresu. Otwiera Google Maps z przystankami w wybranej kolejności. Dostępny również jako addon à la carte dla planu Pro.

Addony à la carte

ShortcodeProponowana stronaKto widziCo robi
[hurt_quote_form] /zapytanie/ Wszyscy (zalogowani i niezalogowani) Formularz zapytania ofertowego — katalog produktów bez cen, koszyk, formularz kontaktowy. Wymaga aktywacji modułu Zapytania ofertowe w System → Moduły.
[hurt_turnover_watch] /klienci-przy-progu/ Przedstawiciel (shop_manager) / admin Lista klientów posortowana według odległości od progu rabatowego. Rep widzi tylko swoich klientów. Atrybuty: per_page (5–100, domyślnie 30), show_all="1" (tylko admin). Wymaga modułu Rabaty progowe.
[hurt_planner] /planowanie-trasy/ Przedstawiciel (shop_manager) / admin Planer trasy — dostępny jako addon dla planu Pro. Identyczna funkcjonalność jak w planie Business. Wymaga aktywacji modułu Planowanie trasy w System → Moduły. Patrz sekcja Business i wyżej po pełny opis.
ℹ️
Moduły Kapsułek i Pakietów nie mają osobnych shortcodów — renderują się automatycznie wewnątrz [hurt_grid] i na stronach produktów gdy moduły są aktywne.

Mapa stron — gotowy przepis na instalację

Utwórz poniższe strony WordPress i wklej odpowiedni shortcode w treść. Slugi są sugestią — możesz je zmienić.

#Tytuł stronySlugShortcodePlan
1Strona główna hurtowni/hurtownia/[hurt_landing]Moduł
2Rejestracja B2B/rejestracja/[hurt_rejestracja]Starter
3Katalog produktów/katalog/[hurt_grid]Starter
4Złóż zamówienie (rep)/zamow/[hurt_checkout]Starter
5Moi klienci/moi-klienci/[hurt_klienci]Starter
6Dodaj klienta/dodaj-klienta/[hurt_dodaj_klienta]Starter
7Komunikator/komunikator/[hurt_chat]Starter
8Zapytanie ofertowe/zapytanie/[hurt_quote_form]Addon
9Klienci przy progu (rep)/klienci-przy-progu/[hurt_turnover_watch]Addon
10Moje wyniki/moje-wyniki/[hurt_moje_wyniki]Pro
11Raporty aktywności/raporty/[hurt_raport]Pro
12Moje zadania/zadania/[hurt_tasks]Pro
13Dashboard zarządczy/dashboard/[hurt_dashboard_prezes]Pro
14Rozliczenia (księgowy)/ksiegowosc/[hurt_ksiegowy]Business
15Planowanie trasy (rep)/planowanie-trasy/[hurt_planner]Business / Addon
⚠️
Po utworzeniu stron: Wejdź w Panel Hurtownia → Hurtownia → Siatka produktów i wpisz URL strony zamówień (/zamow/) w polu "URL Pre-Checkout". Bez tego przycisk "Przejdź do zamówienia" kieruje do standardowego koszyka WooCommerce zamiast do pre-checkout dla repów.