Do czego służy wtyczka
Szybki formularz zamówień dla klientów hurtowych i firmowych. Zamiast przeglądać sklep produkt po produkcie, klient wybiera kategorię, markę albo wpisuje SKU, widzi tabelę z cenami i stanem i dodaje do koszyka całe ilości – bez przeładowania strony. Dostęp mają tylko wybrane role, np. dystrybutorzy.
Co potrafi
Filtry, które znają hurtownicy
Klient filtruje po kategorii (z podkategoriami), po marce i po SKU lub numerze katalogowym. Wyniki pojawiają się od razu – wystarczy wybrać filtr albo zacząć pisać kod.
Efekt: stały klient składa zamówienie na kilkadziesiąt pozycji w kilka minut.
Tabela z ceną, stanem i ilością
Każdy wiersz ma zdjęcie, nazwę, krótki opis, SKU, numer katalogowy, dostępność i cenę – przy promocji z ceną przekreśloną i procentem rabatu. Obok jest pole ilości i przycisk Kup. Ilość nie przekroczy tego, ile można kupić. Produkty z wariantami mają przycisk Wybierz opcje.
Efekt: wszystko, czego klient potrzebuje do decyzji, widzi w jednym wierszu.
Dostęp tylko dla wybranych
Wyszukiwarkę widzą wyłącznie zalogowani użytkownicy z zaznaczonymi rolami – albo z każdą rolą zaczynającą się od ustalonego przedrostka, np. „vip” (vip, vip_gold, vip-dystrybutor). Pozostali zobaczą Twój komunikat, np. prośbę o zalogowanie.
Efekt: ceny i stany dla partnerów nie są widoczne dla wszystkich.
Dokładne stany tam, gdzie chcesz
Dla wybranych marek wyszukiwarka pokazuje dokładną liczbę sztuk na stanie, a dla pozostałych tylko „Dostępny”. Produkty niedostępne możesz ukryć.
Dobrze wiedzieć
- Wyszukiwarkę wstawiasz shortcodem
[b2b_product_search]na dowolną stronę. - Numer katalogowy to dowolne pole własne produktu (np.
_catalog_number) – wyszukiwarka przeszukuje je razem z SKU. - Filtr marek pojawia się, gdy w sklepie są marki WooCommerce (Produkty → Marki).
- Działa z WPML i Polylang – wyniki są w języku strony.
- Wtyczka jest zgodna z HPOS i kasą blokową WooCommerce.
Instalacja i pierwsze ustawienia
Zanim zaczniesz
Potrzebujesz WordPressa 6.2 lub nowszego, WooCommerce 8.0+ i PHP 7.4+ oraz konta administratora. Przed instalacją każdej nowej wtyczki zrób kopię zapasową sklepu – w większości paneli hostingowych to jeden przycisk.
Krok 1: pobierz wtyczkę i klucz licencyjny
Po zamówieniu (wersji Pro albo bezpłatnej wersji Free na 5 dni) dostajesz e-mail z kluczem licencyjnym i przyciskiem Pobierz. Ten sam klucz i plik znajdziesz zawsze w Moje konto → Licencje na wpasist.eu.
- Kliknij Pobierz i zapisz plik
b2b-product-search-for-woocommerce.zipna komputerze. - Nie rozpakowuj pliku – WordPress instaluje wtyczkę prosto z ZIP-a.
Safari na Macu potrafi sam rozpakować pobrany plik. Jeśli zamiast pliku ZIP widzisz folder, spakuj go z powrotem (prawy przycisk myszy → Kompresuj) albo wyłącz w Safari opcję otwierania „bezpiecznych” plików po pobraniu.
Krok 2: zainstaluj i włącz wtyczkę
- Zaloguj się do panelu WordPressa (zwykle
twojsklep.pl/wp-admin). - Wejdź w Wtyczki → Dodaj nową wtyczkę i kliknij Wyślij wtyczkę na serwer.
- Wybierz plik
b2b-product-search-for-woocommerce.zipi kliknij Zainstaluj. - Po komunikacie „Wtyczka została zainstalowana” kliknij Włącz wtyczkę.
Wynik: w menu po lewej masz pozycję wpAsist, a w niej tę wtyczkę i ekran Licencje.
Krok 3: aktywuj licencję
- Wejdź w wpAsist → Licencje.
- Przy tej wtyczce wklej klucz z e-maila i kliknij Aktywuj licencję.
- Status zmieni się na Aktywna do … (data końca licencji).
Bez aktywnej licencji wyszukiwarka się nie wyświetla (administrator widzi w jej miejscu informację o licencji). Ustawienia zostają zapisane.
Klucz działa na jednej domenie. Przeniesienie sklepu na inny adres zrobisz sam w Moje konto → Licencje → Zmień domenę na wpasist.eu. Nowe wersje wtyczki przychodzą w panelu jak każda aktualizacja WordPressa (Kokpit → Aktualizacje), dopóki licencja jest aktywna – ustawienia zostają bez zmian.
Krok 4: ustaw dostęp i wygląd
Wejdź w wpAsist → Wyszukiwarka B2B, zakładka Ustawienia.
| Pole | Co oznacza | Przykład |
|---|---|---|
| Kto ma dostęp | Zaznacz role, które mogą korzystać z wyszukiwarki. | Klient hurtowy |
| Dodatkowo każda rola, której ID zaczyna się od | Przedrostek ID roli – dostęp dostaje każda pasująca rola. Puste = tylko zaznaczone role. | vip |
| Dokładny stan magazynowy | Marki, dla których widać liczbę sztuk na stanie. | Twoja marka |
| Produkty niedostępne | Ukrywa produkty, których nie ma na stanie. | zaznaczone |
| Maksymalna liczba wyników | Ile produktów najwyżej pokazać naraz (1–1000). | 300 |
| Pole numeru katalogowego | Nazwa pola własnego z numerem katalogowym. Puste = szukanie tylko po SKU. | _catalog_number |
| Czcionka | Czcionka Poppins z Google Fonts. Odznacz, by użyć czcionki motywu. | odznaczone |
| Tekst nad wyszukiwarką | Krótka instrukcja dla klienta nad filtrami. | Wybierz kategorię albo wpisz SKU. |
| Komunikat dla osób bez dostępu | Tekst dla niezalogowanych i osób bez uprawnień. Puste = tekst domyślny. | Zaloguj się, aby zobaczyć ceny hurtowe. |
Kliknij Zapisz zmiany.
Po instalacji dostęp ma tylko administrator, a przedrostek roli to „vip”. Zaznacz role swoich klientów, zanim udostępnisz stronę.
Krok 5: utwórz stronę z wyszukiwarką
- Wejdź w Strony → Dodaj nową, nazwij ją np. „Szybkie zamówienie”.
- Dodaj blok Shortcode (w Elementorze: widżet „Shortcode”) i wpisz
[b2b_product_search]. - Opublikuj stronę i dodaj ją do menu konta klienta albo menu głównego.
Krok 6: sprawdź jako klient
- Zaloguj się na konto z rolą, która ma dostęp (np. testowego klienta hurtowego).
- Otwórz stronę, wybierz kategorię – pojawia się tabela produktów.
- Wpisz ilość przy produkcie i kliknij Kup – pojawi się komunikat „dodano do koszyka”.
- Wyloguj się i otwórz stronę ponownie – zobaczysz komunikat dla osób bez dostępu.
Najczęstsze problemy
| Objaw | Co zrobić |
|---|---|
| Klient widzi komunikat o braku dostępu | Sprawdź jego rolę w Użytkownicy → Edytuj i czy ta rola jest zaznaczona w „Kto ma dostęp”. |
| Brak filtra marek | W sklepie nie ma marek WooCommerce albo żadna marka nie ma produktów. |
| Wyszukiwanie po numerze katalogowym nie działa | Sprawdź nazwę pola własnego w „Pole numeru katalogowego” – musi być dokładnie taka jak w produktach. |
| „Sesja wygasła” po dłuższym czasie | Odśwież stronę. Wyłącz też cache dla tej strony w wtyczce cache. |
Historia zmian (changelog)
1.0.4 – 2026-10-25
- Poprawka: z WooCommerce Multilingual & Multicurrency (lub innym przełącznikiem walut) tabela produktów pokazywała ceny w walucie bazowej sklepu, podczas gdy reszta sklepu pokazywała walutę klienta – tabela używa teraz tej samej waluty i tych samych przeliczonych cen co sklep.
- Przetestowane z WordPress 7.1 i WooCommerce 11.2 (WPML, Elementor, ponad 100 produktów w kategorii): filtry, szukanie po SKU / numerze katalogowym, ilości i dodawanie do koszyka, dostęp według roli i komunikat dla gości.
1.0.3 – 2026-10-24
- Licencja: wtyczka przy sprawdzaniu klucza podaje swoją nazwę, więc klucz działa tylko we wtyczkach, które obejmuje (jedna wtyczka, pakiet albo All Access).
- wpAsist → Licencje: nowe „Użyj tego klucza we wszystkich wtyczkach wpAsist” – klucz pakietu lub All Access aktywuje się od razu we wszystkich wtyczkach; wtyczki, których klucz nie obejmuje, zachowują własny klucz.
1.0.2 – 2026-10-23
- Nowa instrukcja krok po kroku: co potrafi wtyczka, instalacja i pierwsze ustawienia (readme.txt i instrukcja-pl.txt).
1.0.1 – 2026-10-20
- Aktualizacje prosto z panelu WordPressa (Kokpit → Aktualizacje), dopóki licencja jest aktywna.
- Czytelny komunikat w panelu, gdy licencja nie jest aktywna.
- Wszystkie wtyczki i licencje wpAsist w jednym menu wpAsist.
1.0.0 – 2026-10-18
- Pierwsze wydanie: formularz szybkich zamówień z filtrami kategorii, marki i SKU / numeru katalogowego, shortcode [b2b_product_search].
- Ustawienia: role z dostępem, przedrostek roli, marki z dokładnym stanem, ukrywanie niedostępnych produktów, liczba wyników, pole numeru katalogowego, czcionka, teksty.
- Dodawanie do koszyka uwzględnia maksymalną ilość; produkty z wariantami prowadzą do strony produktu.
- Ceny zgodnie z ustawieniem wyświetlania podatku; język WPML / Polylang zachowany w wyszukiwaniu.
- Pełne polskie tłumaczenie.
Forum dla klientów
Pytaj, zanim się zirytujesz 🙂
Problem po instalacji? Coś niejasne w instrukcji? Tu nie ma głupich pytań, są tylko sklepy, które jeszcze nie działają tak, jak powinny. Odpisujemy osobiście, zwykle tego samego dnia.
Forum dostępne tylko dla klientów. Zaloguj się albo kup wtyczkę, żeby rozwinąć swój sklep razem z nami i móc zadawać pytania i otrzymać wsparcie.
