Piotr Dejneka
Dokumentacja wtyczki

Pierwsze kroki z Vetted

  • Dotyczy wersji 0.2.2
  • Zaktualizowano 6.10.2026
  • 6 min czytania
Na tej stronie
    W skrócie

    Zainstaluj wtyczkę i wpisz klucz w WooCommerceUstawieniaVettedLicencja. Potem przejrzyj ustawienia w tej samej zakładce, wstaw [vetted_rejestracja] na stronie dla firm i wyślij wniosek testowy. Wnioski zobaczysz w WooCommerceWnioski B2B.

    Zanim zaczniesz

    • WordPress 6.5 lub nowszy i PHP 8.1 lub nowszy.
    • Aktywny WooCommerce. Bez niego Vetted niczego nie uruchamia i pokazuje w kokpicie komunikat „Wtyczka Vetted wymaga aktywnego WooCommerce”.
    • Nowe tabele zamówień (HPOS) są obsługiwane.
    • Klasyczny koszyk i zamówienie. Vetted deklaruje w WooCommerce brak zgodności z blokami koszyka i kasy.
    • Rozszerzenie PHP fileinfo. Vetted sprawdza typ załącznika po zawartości pliku, a nie po nazwie.
    • Katalog na pliki chronione poza katalogiem publicznym. Opisuję go niżej.

    Rozszerzenie SOAP nie jest potrzebne. Połączenie z rejestrem REGON idzie zwykłym zapytaniem HTTP.

    Blokowy koszyk nie jest obsługiwany

    Ceny hurtowe działają w klasycznym koszyku i zamówieniu. Jeśli strony „Koszyk” i „Zamówienie” są zbudowane z bloków, wstaw na nich klasyczne shortcode’y

    Twój koszyk aktualnie jest pusty.
    i 
    . Dlaczego to ważne, wyjaśniam w rozwiązywaniu problemów.

    Instalacja

    1. Pobierz paczkę .zip z e-maila po zakupie albo z Moich licencji.
    2. W kokpicie przejdź do WtyczkiDodaj nową wtyczkęWyślij wtyczkę na serwer, wybierz plik i kliknij „Zainstaluj teraz”.
    3. Kliknij „Włącz wtyczkę”.

    Instalacja przez WP-CLI

    Jeśli masz dostęp do serwera, zrobisz to jednym poleceniem. Nazwa pliku z „Moich licencji” ma postać vetted-<wersja>.zip, na przykład vetted-0.2.2.zip.

    Bash
    wp plugin install ./vetted-0.2.2.zip --activate

    Po włączeniu Vetted dodaje dwie role: Wniosek hurtowy w weryfikacji i Klient hurtowy. Obie mają uprawnienia zwykłego klienta WooCommerce. Istniejące konta zostają bez zmian. Role powstają także wtedy, gdy wgrasz pliki z pominięciem aktywacji, na przykład przez rsync.

    Wyłączenie wtyczki nie usuwa ról ani danych. Konto hurtowe nie straci statusu przez przypadkowe kliknięcie.

    Katalog na pliki chronione

    Załączniki z wniosków i materiały dla partnerów leżą poza katalogiem publicznym, więc nie da się ich otworzyć bezpośrednim adresem. Domyślnie Vetted używa katalogu private/vetted, który leży obok katalogu z WordPressem, a nie w nim. Katalog private musi istnieć i mieć prawo zapisu. Podkatalogi Vetted założy sam.

    Jeśli hosting nie daje takiego miejsca, wskaż inny katalog stałą w wp-config.php. Katalog nadrzędny wskazanej ścieżki musi istnieć.

    wp-config.php
    define( 'VETTED_PRIVATE_DIR', '/home/uzytkownik/private/vetted' );

    Gdy katalogu brakuje, w kokpicie zobaczysz czerwony komunikat „Katalog na pliki chronione jest niedostępny. Załączniki w rejestracji nie będą działać.” razem ze ścieżką, której Vetted szuka.

    Aktywacja licencji

    1. Skopiuj klucz licencji z e-maila lub z „Moich licencji”. Ma postać VET-XXXX-XXXX-XXXX-XXXX.
    2. Przejdź do WooCommerceUstawieniaVetted i u góry kliknij „Licencja”.
    3. Wklej klucz w pole „Klucz licencji” i kliknij „Zapisz zmiany”.

    Licencja przypisuje się do domeny sklepu. Po udanej aktywacji zobaczysz zielony komunikat z domeną, datą ważności i liczbą wykorzystanych sklepów. Aktualizacje pojawią się w KokpitAktualizacje.

    Przed przeniesieniem sklepu na inną domenę zaznacz „Dezaktywuj licencję na tej domenie” i zapisz. Miejsce na licencji się zwolni.

    Bez licencji Vetted też działa

    Licencja daje aktualizacje i wsparcie. Po jej wygaśnięciu wtyczka działa dalej, tylko bez nowych wersji. Więcej piszę w artykule Licencje i aktualizacje.

    Ustawienia podstawowe

    Wszystkie ustawienia są w zakładce WooCommerceUstawieniaVetted. Dzielą się na sekcje: „Ceny hurtowe”, „Rejestracja i pliki”, „Weryfikacja w rejestrze REGON (GUS)”, „Teksty formularza i konta” oraz „Wymiana danych”. Na start wystarczą te:

    UstawienieCo robiDomyślnie
    „Domyślne ukrywanie ceny”Wartość wstępnie wybrana przy dodawaniu nowego produktu. Każdy produkt zmienisz osobno.„Pokazuj cenę”
    „Kogo dotyczy ukrycie”Tylko niezalogowanych albo wszystkich poza zatwierdzonym hurtem.„Tylko niezalogowanych”
    „Wezwanie zamiast ceny (gość)”Tekst w miejscu ukrytej ceny.„Zaloguj się, aby zobaczyć cenę”
    „Wezwanie zamiast ceny (wniosek w weryfikacji)”Tekst dla konta, które czeka na decyzję.„Cena widoczna po zatwierdzeniu wniosku”
    „Adres strony dla profesjonalistów”Dokąd prowadzi wezwanie zamiast ceny.puste, czyli strona „Moje konto”
    „Limit rozmiaru załącznika (MB)”Największy plik przy wniosku i przy materiale dla partnerów. Od 1 do 50.5
    „Retencja załączników (dni)”Po ilu dniach od decyzji plik z wniosku jest usuwany. Zero wyłącza usuwanie.30
    „Adres powiadomień o wnioskach”Dokąd trafia e-mail o nowym wniosku. Kilka adresów oddziel przecinkami.puste, czyli e-mail administratora
    „Automatyczna akceptacja”Zatwierdza od razu wniosek z NIP-em, gdy wpis w REGON jest aktywny, a kod PKD firmy jest na liście „Kody PKD: akceptacja”. Wyłączona oznacza, że każdy wniosek czeka na Twoją decyzję.wyłączona

    W sekcji „Teksty formularza i konta” dopasujesz do swojej branży wstęp formularza, listę korzyści, opisy obu ścieżek i zachętę w „Moim koncie”. Puste pole przywraca tekst domyślny.

    Okres retencji a polityka prywatności

    Jeśli zmienisz liczbę dni, popraw też politykę prywatności sklepu. Okres przechowywania dokumentów musi się w obu miejscach zgadzać.

    Strona rejestracji dla firm

    1. Utwórz stronę, na przykład „Dla profesjonalistów”, i wstaw w niej shortcode [vetted_rejestracja].
    2. Opublikuj stronę i skopiuj jej adres.
    3. Wklej adres w ustawieniu „Adres strony dla profesjonalistów”. Od teraz wezwanie zamiast ceny prowadzi do formularza.
    4. Otwórz stronę w oknie prywatnym i sprawdź formularz.
    Shortcode
    [vetted_rejestracja]

    Przycisk „Złóż wniosek” w zakładce „Zostań partnerem” w „Moim koncie” Vetted ustawia sam. Szuka opublikowanej strony z tym shortcode’em, więc strona może się nazywać dowolnie i leżeć w dowolnym miejscu. Przycisk pojawia się zaraz po opublikowaniu strony, a po zmianie jej adresu Vetted odczytuje adres na nowo.

    Vetted nie dołącza własnych arkuszy stylów. Wygląd formularza zależy od motywu, więc obejrzyj go na telefonie i na komputerze.

    Rejestr REGON na start

    Po instalacji ustawienie „Środowisko” ma wartość „Testowe”. Vetted korzysta wtedy z publicznego klucza środowiska testowego GUS, więc przycisk „Pobierz dane z GUS” działa od razu. Dane są tam zanonimizowane, a adresy zamaskowane.

    Przed startem sprzedaży zmień środowisko na „Produkcyjne” i wpisz własny klucz do API rejestru REGON. Bezpieczniej dodać go w wp-config.php, bo wtedy nie trafia do kopii zapasowych bazy:

    wp-config.php
    define( 'VETTED_GUS_KEY', 'twoj-klucz' );

    Po instalacji każdy wniosek czeka na Twoją decyzję, także w środowisku testowym. Konta zatwierdzane od razu włączysz ustawieniem „Automatyczna akceptacja” razem z listą „Kody PKD: akceptacja”. Szczegóły opisuję w artykule Weryfikacja firm i GUS.

    Pierwszy wniosek

    Sprawdź obie ścieżki formularza. Każda kończy się inaczej.

    Ilustracja: formularz dla gościa w ścieżce „Mam NIP”. Zalogowany klient nie widzi pól e-maila i hasła, a ścieżka „Nie mam NIP” zamiast pola NIP ma pole na dokument.
    1. W oknie prywatnym wyślij wniosek w ścieżce „Nie mam NIP” z małym plikiem PDF. Konto powstaje i od razu się loguje, a na podany adres przychodzi e-mail „Mamy Twój wniosek o konto firmowe”.
    2. W kokpicie przejdź do WooCommerceWnioski B2B. Wniosek czeka w zakładce „Oczekujące”, a przy pozycji menu widać licznik.
    3. Kliknij „Zatwierdź”. Klient dostaje e-mail, a decyzja zapisuje się w „Dzienniku decyzji”.
    4. Zaloguj się na to konto i sprawdź ceny produktów, w których wpisałeś cenę hurtową.
    5. Wyślij drugi wniosek, tym razem w ścieżce „Mam NIP”. Przy wyłączonej „Automatycznej akceptacji” on też czeka w zakładce „Oczekujące”, a w kolumnie „REGON” zobaczysz dane z rejestru. Jeśli automat jest włączony, a rejestr potwierdzi aktywny wpis z kodem PKD z Twojej listy, konto zostanie zatwierdzone od razu i trafi do zakładki „Zatwierdzone”.
    Wniosek z konta administratora jest bezpieczny

    Vetted nigdy nie zmienia roli kont obsługi sklepu. Wniosek zapisze się i pojawi w kolejce, ale panel zostaje dostępny. Do sprawdzania cen hurtowych użyj jednak osobnego konta klienta, bo konto obsługi nie dostaje ról hurtowych.

    Co dalej

    Czy ta strona pomogła?

    Ostatnia zmiana: 6.10.2026, wersja 0.2.2Zgłoś błąd w tej stronie