Pierwsze kroki z Docket

• Dotyczy wersji 0.5.1
• Zaktualizowano 6.10.2026
• 6 min czytania

Wymagania

• WordPress 6.5 lub nowszy.
• PHP 8.1 lub nowszy.
• WooCommerce musi być aktywne. Bez niego Docket nic nie uruchamia i pokazuje w kokpicie komunikat „Wtyczka Docket wymaga aktywnego WooCommerce”. Pole GTIN w feedzie Google wymaga WooCommerce 9.2 lub nowszego.
• Kasa blokowa wymaga WooCommerce 9.9 lub nowszego. Starsza wersja nie obsługuje pól warunkowych, więc Docket wtedy nie dodaje pól do bloku „Kasa”.
• Baza danych MySQL albo MariaDB. Licznik numeracji korzysta z funkcji LAST_INSERT_ID().
• HPOS: Docket deklaruje zgodność z tabelami zamówień WooCommerce i z kasą blokową.

Instalacja

Paczkę .zip pobierzesz w Moich licencjach, przyciskiem „Pobierz” przy licencji Docket.

1. W kokpicie wejdź w WtyczkiDodaj nową wtyczkęWyślij wtyczkę na serwer, wybierz plik zip i kliknij „Zainstaluj teraz”. Możesz też skopiować katalog docket do wp-content/plugins/.
2. Włącz wtyczkę. WooCommerce musi być już aktywne.
3. Przy aktywacji Docket tworzy małą tabelę licznika numeracji i zleca odświeżenie reguł adresów (potrzebne dla feedu Google).
4. Na liście wtyczek przy Docket pojawi się odnośnik „Ustawienia”. Prowadzi do zakładki WooCommerceUstawieniaDocket.

Instalacja przez WP-CLI

Jeśli masz dostęp do serwera, zainstaluj i włącz paczkę jednym poleceniem. Nazwa pliku z „Moich licencji” ma postać docket-<wersja>.zip, na przykład docket-0.5.1.zip.

wp plugin is-active woocommerce && wp plugin install ./docket-0.5.1.zip --activate

Ustawienia możesz potem odczytać poleceniem wp option get, na przykład wp option get docket_number_format. Licencję aktywuj jednak w panelu: wtyczka łączy się z serwerem licencji dopiero przy zapisie ekranu „Licencja”.

Pierwsza konfiguracja

1. Otwórz zakładkę WooCommerceUstawieniaDocket i sprawdź „Format numeru”. Pod nagłówkiem sekcji widać numer, który dostanie następne zamówienie.
2. W polu „Administrator danych” wpisz pełną nazwę firmy. Puste pole oznacza nazwę witryny.
3. Sprawdź, czy w WooCommerce wskazana jest strona regulaminu (WooCommerceUstawieniaZaawansowane), a w WordPressie strona polityki prywatności (UstawieniaPrywatność). Od nich zależą zgody, wersje dokumentów i odnośniki w tekstach.
4. Jeśli chcesz mierzyć ruch, wpisz identyfikator GA4 lub Meta Pixel. Jeśli wysyłasz produkty do Google, włącz feed.
5. Kliknij „Zapisz zmiany”.

Licencja

Docket działa bez licencji. Klucz daje automatyczne aktualizacje i wsparcie. Wpisujesz go w osobnej sekcji tej samej zakładki: WooCommerceUstawieniaDocketLicencja. Klucz ma format DOC-XXXX-XXXX-XXXX-XXXX. Szczegóły aktywacji, limitu sklepów i odnowienia opisałem w artykule Licencje i aktualizacje.

Moduły i ich włączniki

Każdy moduł ma włącznik w zakładce Docket. Wyłączony moduł nie dodaje niczego do sklepu. Wyjątkiem jest numeracja: nadane numery są widoczne także po wyłączeniu modułu.

Dostępność kasy w skrócie

Ten moduł nie ma osobnego artykułu, bo nie ma ustawień poza włącznikiem. W klasycznej kasie nadaje grupie metod płatności nazwę „Metoda płatności” dla czytników ekranu, zamienia nagłówki sekcji kasy z h3 na h2, wiąże komunikaty błędów z polami i przenosi fokus na listę błędów. Gdy strona jest po polsku, podmienia też kilka komunikatów walidacji WooCommerce na krótsze polecenia, na przykład „Uzupełnij pole %s”. Szablonów WooCommerce nie nadpisuje.

Kasa klasyczna a blokowa

Docket rozpoznaje kasę blokową po bloku „Kasa” na stronie kasy. W motywie blokowym sprawdza też szablon kasy. Wynik możesz wymusić filtrem docket_block_checkout, opisanym w artykule dla deweloperów.

Numeracja, regulamin przy rejestracji konta, analityka i feed działają tak samo przy obu rodzajach kasy. W kasie blokowej różni się kilka rzeczy:

• Dane do faktury to pola dodatkowe WooCommerce w sekcji danych kontaktowych. NIP pokazuje się i staje się wymagany dopiero po zaznaczeniu przełącznika faktury.
• Nazwa firmy pochodzi z pola „Firma” w adresie. Gdy to pole jest ukryte w ustawieniach bloku „Kasa”, Docket dodaje własne pole „Nazwa firmy”.
• Zgoda marketingowa jest w sekcji „Dodatkowe informacje do zamówienia”.
• Regulamin akceptuje się w bloku „Regulamin”. Docket zapisuje tę akceptację w rejestrze zgód razem z wersją dokumentu.
• Informacja o danych stoi nad przyciskiem zamówienia.
• Poprawki dostępności nie działają w bloku „Kasa”. Blok ma własną obsługę błędów i fokusu.

Gdy kasa jest blokowa, zakładka Docket pokazuje te różnice w ramce informacyjnej. Pokazuje też ostrzeżenie, jeśli w kasie brakuje bloku „Regulamin” albo blok pokazuje samo zdanie bez pola wyboru.

Ograniczenia kasy blokowej

• Pole „Firma” z adresu nie może być warunkowo wymagane. Brak nazwy firmy przy zaznaczonej fakturze zatrzymuje zamówienie dopiero przy jego składaniu, komunikatem nad formularzem.
• Komunikat o pustym NIP-ie pochodzi z WooCommerce. Komunikat o błędnym NIP-ie pochodzi z Docket.
• Zdarzenie add_payment_info korzysta z akcji JavaScript bloku, którą WooCommerce oznacza jako eksperymentalną. Jeśli WooCommerce zmieni jej nazwę, to jedno zdarzenie przestanie wychodzić. Reszta działa dalej.
• Pola z sekcji danych kontaktowych WooCommerce pokazuje też w „Moim koncie”, w danych konta. Dlatego Docket rejestruje je tylko przy kasie blokowej.

Jeśli coś nie działa tak, jak opisuję, napisz przez wsparcie.

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