Inpost Paczkomaty

Sharraxaad

Inpost Paczkomaty to lekka, w pełni spolszczona wtyczka, która dodaje Paczkomaty InPost jako formę dostawy w sklepie WooCommerce. Klient wybiera paczkomat na wygodnej mapce (oficjalny GeoWidget InPost) bezpośrednio w koszyku lub w kasie, a Ty od razu widzisz wybrany punkt odbioru w panelu zamówienia, w mailu z potwierdzeniem i na stronie z podziękowaniem za zakup.

Wtyczka działa od razu po aktywacji – wystarczy dodać nową metodę wysyłki w ustawieniach WooCommerce, bez konfigurowania kluczy API czy dodatkowych usług zewnętrznych.

Najważniejsze funkcje

  • Mapka wyboru Paczkomatu (oficjalny GeoWidget InPost) w koszyku i podczas składania zamówienia.
  • Automatyczna obsługa zarówno klasycznego koszyka/checkoutu (shortcode [woocommerce_cart] / [woocommerce_checkout]), jak i nowego blokowego checkoutu WooCommerce Blocks – wtyczka sama wykrywa, którego trybu używa Twój sklep.
  • Zapisywanie wybranego paczkomatu w zamówieniu, w mailu z potwierdzeniem oraz w panelu administratora przy zamówieniu.
  • Opcjonalne ustawienie wybranego paczkomatu jako adresu wysyłki zamówienia.
  • Limity wagi i wymiarów paczki – możliwość ukrycia metody wysyłki lub automatycznego podziału zamówienia na kilka paczek po przekroczeniu limitu.
  • Konfigurowalne progi cenowe (minimalna/maksymalna wartość zamówienia), np. darmowa dostawa od określonej kwoty koszyka.
  • Możliwość dodania własnego logo InPost w koszyku i kasie.
  • Gotowe pola meta zamówienia (m.in. _paczkomat_id, delivery_point_name, delivery_point_city) ułatwiające integrację z systemami zewnętrznymi.
  • Pełna obsługa HPOS (High-Performance Order Storage) w nowszych wersjach WooCommerce.
  • Wtyczka jest w pełni przetłumaczona na język polski i gotowa do tłumaczenia na inne języki (Text Domain: inpost-paczkomaty).

Dla kogo jest ta wtyczka

Dla każdego sklepu WooCommerce, który chce zaoferować klientom wygodny odbiór przesyłek w Paczkomatach InPost, bez konieczności wdrażania rozbudowanych integracji kurierskich.

Bezpieczeństwo i jakość kodu

Kod wtyczki jest regularnie przeglądany pod kątem bezpieczeństwa – weryfikacja nonce na endpointach AJAX, kontrola uprawnień, escapowanie danych wyjściowych oraz sanitizacja zapisywanych ustawień. Szczegóły poszczególnych poprawek znajdziesz w sekcji Changelog.

Podoba Ci się wtyczka?

Jeśli Inpost Paczkomaty pomogła Ci zaoszczędzić czas w Twoim sklepie, będę ogromnie wdzięczny za zostawienie oceny ⭐⭐⭐⭐⭐ w zakładce Reviews – to najprostszy sposób, żeby wtyczka trafiała do kolejnych właścicieli sklepów WooCommerce. Potrzebujesz dodatkowej funkcji, integracji z innym systemem albo pomocy z wdrożeniem u siebie? Zajrzyj do sekcji Wsparcie poniżej – realizuję również płatne zlecenia indywidualne.

Support

Wtyczka jest darmowa i rozwijana w moim wolnym czasie. Jeśli pomogła Ci zaoszczędzić czas lub zarobić pieniądze w Twoim sklepie, poniżej znajdziesz kilka sposobów, jak możesz się odwdzięczyć i pomóc jej dalej się rozwijać:

Masz pytanie techniczne? Najpierw sprawdź sekcję FAQ powyżej, a jeśli nie znajdziesz odpowiedzi – zapraszam do zakładki Support.

Dziękuję za korzystanie z wtyczki!

Sawir-shaashado

SBI

Jak dodać Paczkomaty jako formę dostawy?

Po aktywowaniu wtyczki przejdź do WooCommerce -> Ustawienia -> Wysyłka -> wybierz odpowiednią strefę wysyłki i dodaj nową metodę dostawy typu “Inpost Paczkomaty”.

Nie widzę przycisku “Wybierz paczkomat” w koszyku/kasie – co mogę zrobić?

Wtyczka automatycznie wykrywa, czy Twój sklep korzysta z klasycznego koszyka/checkoutu (shortcode) czy z nowego, blokowego WooCommerce Blocks – nie trzeba nic przełączać ręcznie. Sprawdź w panelu WooCommerce -> Inpost Paczkomaty pole “Tryb checkout (wykryty automatycznie)”:

  • Jeśli widnieje status “⚠️ Wykryto konflikt” (koszyk i checkout korzystają z różnych trybów), wybierz ręcznie odpowiedni tryb w tym samym panelu lub ujednolić obie strony (najlepiej obie na blokach albo obie na shortcode).
  • Jeśli mimo poprawnie wykrytego trybu przycisk nadal się nie pojawia, upewnij się, że wybrana jest metoda dostawy “Inpost Paczkomaty”, a następnie wyłącz chwilowo inne wtyczki (patrz pytanie poniżej).

Używam klasycznego koszyka/checkoutu opartego na shortcode – czy muszę coś ustawiać?

Nie. Wtyczka wykrywa to automatycznie na podstawie zawartości stron koszyka i checkoutu. Jeśli wcześniej zamieniłeś/aś te strony na bloki i chcesz wrócić do wersji shortcode, w panelu WooCommerce -> Inpost Paczkomaty znajdziesz przycisk “Przywróć” przy opcji “Przywróć klasyczny widok koszyka i kasy” (zalecana wcześniejsza kopia zapasowa).

Używam nowego, blokowego koszyka/checkoutu WooCommerce – czy muszę coś ustawiać?

Nie, selektor paczkomatu pojawi się automatycznie w sekcji wysyłki bloku koszyka/checkoutu po wybraniu formy dostawy Inpost Paczkomaty – nie trzeba nic dodawać ręcznie w edytorze strony.

Jak ustawić wybrany paczkomat jako adres wysyłki zamówienia?

W panelu administracyjnym przejdź do WooCommerce -> Inpost Paczkomaty i ustaw na “Tak” pole “Zapisz wybrany paczkomat jako adres wysyłki”.

Jak ustawić darmową dostawę od określonej kwoty zamówienia?

Dodaj dwie osobne metody wysyłki “Inpost Paczkomaty” w tej samej strefie. Pierwszej ustaw np. koszt 20 zł i regułę “Pokaż tę metodę wysyłki, gdy… maksymalna wartość zamówienia 60 zł”, a drugiej koszt 0 zł i regułę “…minimalna wartość zamówienia 60 zł”. Kwoty 20 zł i 60 zł są tylko przykładem – dobierz je do swojego sklepu.

Jak ustawić maksymalną wagę produktów dla wysyłki Paczkomatem?

W panelu WooCommerce -> Inpost Paczkomaty ustaw pole “Limit wagowy” na “Tak” oraz podaj wartość w polu “Maksymalna waga (kg)”. Następnie wybierz, co ma się dziać po przekroczeniu limitu: “Ukryj metodę wysyłki” po prostu ukryje wysyłkę Paczkomatem, a “Podziel na kilka paczek” automatycznie przeliczy i pomnoży koszt wysyłki proporcjonalnie do liczby paczek.

Jak ustawić maksymalne wymiary paczki dla wysyłki Paczkomatem?

W panelu WooCommerce -> Inpost Paczkomaty ustaw pole “Ograniczenie wymiarów” na “Tak” oraz uzupełnij pola “Maksymalna szerokość (cm)”, “Maksymalna wysokość (cm)” i “Maksymalna długość (cm)”. Gdy którykolwiek produkt w koszyku przekroczy podane wymiary, metoda wysyłki Inpost Paczkomaty zostanie automatycznie ukryta.

Jak dodać logo InPost w koszyku i kasie?

W panelu WooCommerce -> Inpost Paczkomaty ustaw pole “Pokaż logo w koszyku i kasie” na “Tak”, a następnie wybierz logo z biblioteki mediów. Maksymalna szerokość wyświetlanego logo to 100 px.

Czy wtyczka jest zgodna z najnowszym WordPressem i WooCommerce?

Tak – wtyczka jest na bieżąco testowana z aktualnymi wersjami WordPressa i WooCommerce (patrz pole “Tested up to” na górze tej strony) oraz regularnie aktualizowana pod kątem bezpieczeństwa i zgodności (m.in. pełna obsługa HPOS).

U mnie nie działa / znalazłem błąd – co zrobić?

Wyłącz chwilowo wszystkie wtyczki poza WooCommerce i Inpost Paczkomaty, a następnie sprawdź, czy problem nadal występuje. Jeśli tak, spróbuj przełączyć się na domyślny motyw WordPress (np. Twenty Twenty-Four), aby wykluczyć konflikt z szablonem. Błąd nadal występuje? Napisz w zakładce Support – chętnie pomogę.

Czy planowane jest wsparcie dla kurierów InPost (nie tylko Paczkomatów)?

Tak, rozwój wtyczki jest kontynuowany, a rozszerzenie o kolejne formy dostawy InPost jest na liście planów. Jeśli zależy Ci na konkretnej integracji szybciej, zobacz pytanie poniżej o zlecenia indywidualne.

Potrzebuję dodatkowej funkcji, customizacji albo integracji z innym systemem – co mogę zrobić?

Realizuję płatne wdrożenia i modyfikacje szyte na miarę – dodatkowe pola, integracje z zewnętrznymi systemami (np. kurierskimi, ERP, hurtowniami) czy zmiany wyglądu selektora paczkomatu. Opisz swoją potrzebę przez formularz kontaktowy na grainsoft.pl.

Jak mogę wesprzeć rozwój wtyczki?

Najprościej zostawiając ocenę ⭐⭐⭐⭐⭐ w zakładce Reviews – to bezpośrednio pomaga innym właścicielom sklepów trafić na tę wtyczkę. Możesz też postawić mi kawę ☕ albo zlecić płatne wsparcie/rozwój przez grainsoft.pl.

Dibu-eegisyo

6 Diseembar, 2024 1 reply
Bardzo rozczarowująca wtyczka. Po zgłoszeniu problemu musiałem czekać tydzień na odpowiedź. Gdy w końcu otrzymałem odpowiedź, była ona ogólnikowa, wymijająca i niepomocna. Teraz minął kolejny tydzień, a ja wciąż nie otrzymałem żadnego konkretnego rozwiązania ani follow-upu. Dodatkowo, brak jakichkolwiek aktualizacji wtyczki, co budzi wątpliwości co do dalszego wsparcia i rozwoju. Zdecydowanie nie polecam tej wtyczki.
5 Juunyo, 2024
The plugin works great, the only thing I can complain about is the lack of hiding the shipping method based on the shipping class or custom field
28 Febraayo, 2024
I use Flastome Theme and is really well working together, Thanks for a great job!
25 Diseembar, 2023 1 reply
Cześć, czy jest szansa na dostosowanie wtyczki do obsługi domyślnej konfiguracji WooCommerce od wersji 8.3? Od tej wersji jako domyślny ustawiany jest nowy, fajniejszy checkout blokowy. Można dalej korzystać z legacy – classic, ale byłoby fajnie, gdyby wtyczka działała z domyślnym i docelowym rozwiązaniem. Pozdrawiam Dawid
Akhri dhammaan 32 dibu-eegis

Ka-qaybgalayaasha & Horumariyayaasha

“Inpost Paczkomaty” waa softiweer il furan. Dadka soo socda ayaa wax ku biiriyay kaabahan.

Ka-qaybgalayaasha

“Inpost Paczkomaty” waxaa lagu tarjumay 2 luqadood. Way ku mahadsan yihiin turjumaannada ka-qaybqaadashadooda.

Ku tarjun “Inpost Paczkomaty” luqaddaada.

Ma xiisaynaysaa horumarinta?

Baadh koodka, fiiri bakhaarka SVN, ama iska qor diiwaanka horumarinta adigoo adeegsanaya RSS.

Isbeddellada

1.0.39

  • Bezpieczeństwo: dodano weryfikację nonce (check_ajax_referer) dla endpointów AJAX zapisujących i odczytujących wybrany paczkomat (set_paczkomat, get_paczkomat_session) w obu trybach koszyka – blokowym i klasycznym.
  • Bezpieczeństwo: endpoint przywracający koszyk/checkout do wersji klasycznej (przycisk “Przywróć”) wymaga teraz uprawnienia manage_options oraz prawidłowego nonce – wcześniej mógł zostać wywołany przez dowolnego zalogowanego użytkownika, również przez CSRF.
  • Bezpieczeństwo: dane wybranego paczkomatu (nazwa, adres) są teraz każdorazowo escapowane (esc_html/esc_url) przy wyświetlaniu w koszyku/checkoucie klasycznym oraz w panelu zamówienia, co eliminuje potencjalny XSS.
  • Bezpieczeństwo: usunięto budowanie DOM przez innerHTML z danymi widgetu InPost na rzecz bezpiecznego textContent w skrypcie modala paczkomatu.
  • Bezpieczeństwo: dodano sanitize_callback dla opcji wtyczki (register_setting) – zapisywane są tylko rozpoznane pola, każde rzutowane na oczekiwany typ (yes/no, liczby, URL, enum).
  • Poprawka: zabezpieczono przed błędem krytycznym w powiadomieniu admina, gdy get_current_screen() zwraca null.
  • Poprawka: usunięto niespójny text domain (inpost_paczkomaty -> inpost-paczkomaty) w opisie ustawienia kosztu wysyłki.
  • Potwierdzono zgodność z najnowszym WordPress 7.0.2.
  • Poprawka: naprawiono błędne wywołanie _e() zamiast __() w odpowiedzi JSON endpointu przywracania koszyka/checkoutu.
  • Odświeżono opis wtyczki oraz sekcję FAQ w readme – usunięto nieaktualne informacje o dawnym checkboksie trybu koszyka, dodano opis wszystkich aktualnych funkcji.

1.0.38

  • Poprawka detekcji konfliktu trybów – przypadek gdy koszyk jest blokowy a checkout klasyczny (lub odwrotnie) jest teraz prawidłowo wykrywany.
  • W panelu admina przy wykrytym konflikcie pojawia się czerwony badge “⚠️ Conflict detected” z informacją które strony używają jakiego trybu.
  • Dodano możliwość ręcznego wyboru trybu (block/classic) gdy wykryty jest konflikt – opcja zapisywana w ustawieniach i aktywna tylko przy konflikcie.

1.0.37

  • Automatyczne wykrywanie trybu checkout (classic checkout / block checkout) na podstawie zawartości strony koszyka i checkoutu – bez potrzeby ręcznego ustawiania checkboxa.
  • Usunięcie checkboxa “I want to use legacy (PHP) cart/checkout” – tryb jest teraz wybierany automatycznie.
  • Nowy badge w panelu ustawień informujący o aktualnie wykrytym trybie: “Classic checkout (shortcode)” lub “Block checkout (WooCommerce Blocks)”.
  • Zmiana terminologii w kodzie: “legacy” “classic checkout”, “block mode” “block checkout”.
  • Zmiana nazwy pliku includes/checkout-legacy.php na includes/checkout-classic.php.
  • Uzupełnienie polskich tłumaczeń dla nowych ciągów (auto-detect, nazwy trybów).

1.0.36

  • Poprawa powiadomienia w panelu administracyjnym – nowy układ z linkami do oceny, wsparcia projektu i płatnego wsparcia technicznego.
  • Uzupełnienie i poprawienie polskich tłumaczeń dla wszystkich nowych ciągów dodanych w wersji 1.0.35 (tryb blokowy, ustawienia checkboxu, limit wagi).
  • Dodanie sekcji Wsparcie w pliku readme.

1.0.35

  • Dodanie obsługi nowego blokowego koszyka i checkoutu WooCommerce (WooCommerce Blocks).
  • Nowy checkbox w ustawieniach: “I want to use legacy (PHP) cart/checkout” – pozwala wybrać tryb klasyczny (shortcode) lub blokowy.
  • W trybie blokowym: selektor paczkomatu pojawia się automatycznie w sekcji wysyłki bloku checkout/cart po wybraniu formy dostawy InPost Paczkomaty.
  • Integracja z WooCommerce Blocks API (IntegrationInterface, ExperimentalOrderShippingPackages) – skrypt ładowany przez wp_enqueue_scripts jako fallback dla starszych wersji WC Blocks.
  • Zapis danych paczkomatu do zamówienia przez hook Store API (woocommerce_store_api_checkout_order_processed) z fallbackiem na woocommerce_checkout_order_created.
  • Przełączenie z add_meta_data na update_meta_data – poprawna obsługa HPOS (High-Performance Order Storage).
  • Przywrócenie wybranego paczkomatu po odświeżeniu strony (AJAX get_paczkomat_session odczytuje dane z sesji PHP).
  • Podział kodu na osobne pliki: includes/checkout-legacy.php (tryb klasyczny) i includes/checkout-blocks.php (tryb blokowy).
  • Walidacja brakującego paczkomatu w trybie blokowym przez RouteException (Store API).

1.0.34

  • Poprawa ustawień dotyczących limitów wymiarów oraz wagi.

1.0.33

  • Dodanie przycisku w ustawieniach który zamienia koszyk i checkout na shortcode’y “[wooommerce_checkout]” oraz “[woocommerce_cart]”.

1.0.32

  • Naprawa błędu z duplikującymi się meta danymi przez co integracje otrzymywały podwójne dane

1.0.31

  • Dodanie komunikatu w panelu w ustawieniach

1.0.30

  • Naprawa błędu z pojawiającymi się warningami o braku elementu w tablicy

1.0.29

  • Naprawa błędu przez który nie dało się dodać zdjęcia do produktu
  • Naprawa tłumaczeń

1.0.28

  • Dodanie możliwości ustawienia loga w koszyku i checkoucie
  • Dodanie możliwości ustawienia limitu dla wagi produktów w koszyku
  • dodanie możliwości ustawiania limitu dla wymiarów produktu

1.0.27

  • Poprawka przekazywania danych o paczkomacie do panelu
  • Naprawa błędu z przekazywaniem danych do baselinka w niektórych przypadkach

1.0.26

  • Wsparcie dla php 8.2
  • Wsparcie dla wordpress 6.4.1

1.0.25

  • Poprawa integracji z baselinkerem

1.0.24

  • Drobne poprawki

1.0.23

  • Przeniesienie zakładki z ustawieniami do podmenu woocommerce
  • Poprawa tłumaczeń

1.0.23

  • Dodanie meta_data aby zamówienia integrowały się z baselinkerem

1.0.22

  • Dodanie zakładki z konfiguracją
  • Dodanie możliwości ustawienia aby dane wybranego paczkomaty były zaczytywane jako “adres wysyłki”.

1.0.21

  • Poprawa walidacji w przypadku gdy została wybrana wysyłka paczkomatem ale nie został wybrany paczkomat.
  • Poprawa czytelności kodu

1.0.20

  • Poprawienie błędu w przypadku produktów wirutalnych

1.0.19

  • Zabezpieczenie przed pojawianiem się błędów w przypadku produktów wirtualnych

1.0.18

  • Poprawa “notice” o przekazywaniu zmiennej przez referencje
  • Nie wyświetlanie informacji o paczkomacie gdy w ostatnim kroku koszyka została zmieniona forma dostawy
  • Przetestowanie wtyczki na wordpressie 6.0.1 oraz PHP 7.4

1.0.17

  • Dodanie checkboxa z “Zastosuj regułę minimalnego zamówienia sprzed użycia kuponu zniżkowego”

1.0.16

  • Rozwiązanie błędu który był generowany w podglądzie customowej wiadomości

1.0.15

  • Dodanie możliwości pokazywanie przesyłki w zakresie “od-do”

1.0.14

  • Rozwiązanie problemu aby powiadomienia braly informacje o przesyłce na podstawie id przesyłki a nie nazwie

1.0.13

  • Rozwiązanie problemu z pojawiającą się informacją o paczkomacie w mailu gdy wybrana inna forma wysyłki

1.0.12

  • Hotfix zwiazany z wysyłką po wersji 1.0.11.

1.0.11

  • Modyfikacja powiadomień (email i strona podziękowania za zamówienie). Pokazywanie paczkomatu w tabelce.

1.0.10

  • Dodanie akcji aby mozna było wyciągnąć dane paczkomatu do customowego powiadomienia mailowego

1.0.9

  • Modyfikacja langów
  • Poprawa Domain dla langów
  • Dodanie możliwości przetłumaczenia dla innych języków
  • Naprawa skryptu w panelu przy wyborze minimalnej/maksymalnej kwoty

1.0.8

  • Dodanie modyfikatorów wysyłki tak aby można było ustawić do wybranej kwoty oraz od wybranej kwoty.

1.0.7

  • poprawa wczytywania skryptu JavaScript w podstronach koszyka.

1.0.6

  • dodanie klas “btn” oraz “button” aby przycisk w koszyku wykorzystywał style szablonu.

1.0.5

  • Dodanie pola z samym numerem paczkomatu do panelu (potrzebne do intergracji z baselinkerem).

1.0.4

  • Nie pokazywanie “wybrany paczkomat” gdy wybrana została inna forma wysyłki.
  • Dodanie informacji o wybranym paczkomacie w potwierdzeniu mailowym do nowego zamówienia.
  • Zablokowanie możliwości zakupu kiedy nie wybrano paczkomatu.
  • Wywoływanie skryptów Inpostu (JS i CSS) tylko na stronie Koszyka i Kasy.

1.0.3

  • Usunięcie przypadkowych znaków.
  • Modyfikacja przesyłania zmiennych pomiędzy etapami.
  • Usunięcie problemu z nieprawidłowymi przypisaniami paczkomatów.

1.0.2

  • Modyfikacja przetwarzania danych w obrębie pluginu.
  • Zamiana odwołań do plików.
  • Zmiana permalinków.

1.0.1

  • Dodanie ustawień na modalu.
  • Dodanie ustawienia kosztów wysyłki według klas wysyłkowych.

1.0.0

  • Dodanie możliwości wyboru paczkomatów.
  • Mapka do paczkomatów w koszyku oraz checkoucie.
  • Zapisywanie do panelu.
  • Zapamiętywanie ostatniego wybranego paczkomatu.