Inpost Paczkomaty
| 开发者 | rimosfafora |
|---|---|
| 更新时间 | 2026年8月17日 16:14 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
标签
下载
详情介绍:
- 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).
屏幕截图:
常见问题:
Gdzie znajdę ustawienia wtyczki?
Panel konfiguracyjny znajduje się w WooCommerce -> Inpost Paczkomaty. Najszybciej trafisz tam klikając link "Ustawienia" przy wtyczce na liście zainstalowanych wtyczek (Wtyczki -> Zainstalowane wtyczki). Pamiętaj, że to dwa różne miejsca: koszty i widoczność samej metody dostawy ustawiasz w strefach wysyłki (WooCommerce -> Ustawienia -> Wysyłka), a globalne opcje wtyczki (limity wagi/wymiarów, logo, adres wysyłki) w WooCommerce -> Inpost Paczkomaty.
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.
更新日志:
- Teksty w bloku wsparcia (ocena wtyczki, wsparcie rozwoju, płatne wsparcie) oraz link "Ustawienia" na liście wtyczek są teraz po polsku niezależnie od języka panelu – wtyczka jest kierowana na rynek polski.
- Cały panel wykrywania trybu koszyka/checkoutu (badge trybu, opisy, informacja o konflikcie i ręczny wybór trybu) jest teraz po polsku na poziomie kodu – wcześniej te opisy mogły wyświetlać się po angielsku, jeśli WordPress użył niekompletnej paczki językowej z translate.wordpress.org zamiast tłumaczenia dołączonego do wtyczki.
- Poprawka: link do kontaktu prowadzi teraz na właściwą sekcję strony (grainsoft.pl/#kontakt zamiast #contact).
- Nowe: na liście wtyczek pojawił się link "Ustawienia" (prowadzący prosto do konfiguracji) oraz linki do oceny wtyczki, wsparcia rozwoju i płatnego wsparcia technicznego.
- Zmiana: informacja o wsparciu na stronie ustawień to teraz czytelna karta z przyciskami zamiast zwykłego powiadomienia – i nie pojawia się już jako notice na innych ekranach panelu.
- Zgodność z WordPress 7.1 – przegląd wtyczki pod kątem zmian z tej wersji (iframowany edytor, client-side media processing, zmiany w @wordpress/components, trwały pasek narzędzi, aktualizacja jQuery UI do 1.14.2).
- Nowe: deklaracja kompatybilności z HPOS (custom_order_tables) oraz blokowym koszykiem/checkoutem (cart_checkout_blocks) – wcześniej WooCommerce oznaczał wtyczkę jako niekompatybilną i mógł blokować włączenie HPOS, mimo że wtyczka w pełni je obsługuje.
- Poprawka: wtyczka poprawnie wykrywa WooCommerce aktywowane sieciowo (network activated) na instalacjach multisite – wcześniej w takiej konfiguracji nie uruchamiała się w ogóle.
- Uzupełniono nagłówki wtyczki (Requires at least, Requires PHP, Requires Plugins, License) zgodnie z wymaganiami Plugin Check i mechanizmu zależności wtyczek z WordPress 6.5+.
- Poprawka: dodano brakującą domenę tłumaczenia (text domain) dla dwóch ciągów, które nigdy nie były tłumaczalne ("Paczkomat" w tabeli zamówienia oraz komunikat walidacji w checkoucie klasycznym).
- Poprawka: uzupełniono plik tłumaczenia pl_PL o 4 brakujące, wyświetlane dotąd po angielsku komunikaty (m.in. opisy pól "Ograniczenie wymiarów" i "Zapisz wybrany paczkomat jako adres wysyłki") oraz usunięto 8 nieużywanych wpisów po dawnej funkcji "legacy checkbox".
- Poprawka: naprawiono literówkę "Sukcess" -> "Sukces" oraz nieprzetłumaczone/zniekształcone frazy (brak polskich znaków) w pliku tłumaczenia.
- Zaktualizowano szablon tłumaczeń (.pot), który był nieaktualny od 2021 r. i nie zawierał ok. 20 nowszych ciągów – ułatwi to tworzenie tłumaczeń na inne języki.
- 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 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.
- 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.
- 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).
- 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.
- 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).
- Poprawa ustawień dotyczących limitów wymiarów oraz wagi.
- Dodanie przycisku w ustawieniach który zamienia koszyk i checkout na shortcode'y "[wooommerce_checkout]" oraz "[woocommerce_cart]".
- Naprawa błędu z duplikującymi się meta danymi przez co integracje otrzymywały podwójne dane
- Dodanie komunikatu w panelu w ustawieniach
- Naprawa błędu z pojawiającymi się warningami o braku elementu w tablicy
- Naprawa błędu przez który nie dało się dodać zdjęcia do produktu
- Naprawa tłumaczeń
- 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
- Poprawka przekazywania danych o paczkomacie do panelu
- Naprawa błędu z przekazywaniem danych do baselinka w niektórych przypadkach
- Wsparcie dla php 8.2
- Wsparcie dla wordpress 6.4.1
- Poprawa integracji z baselinkerem
- Drobne poprawki
- Przeniesienie zakładki z ustawieniami do podmenu woocommerce
- Poprawa tłumaczeń
- Dodanie meta_data aby zamówienia integrowały się z baselinkerem
- Dodanie zakładki z konfiguracją
- Dodanie możliwości ustawienia aby dane wybranego paczkomaty były zaczytywane jako "adres wysyłki".
- Poprawa walidacji w przypadku gdy została wybrana wysyłka paczkomatem ale nie został wybrany paczkomat.
- Poprawa czytelności kodu
- Poprawienie błędu w przypadku produktów wirutalnych
- Zabezpieczenie przed pojawianiem się błędów w przypadku produktów wirtualnych
- 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
- Dodanie checkboxa z "Zastosuj regułę minimalnego zamówienia sprzed użycia kuponu zniżkowego"
- Rozwiązanie błędu który był generowany w podglądzie customowej wiadomości
- Dodanie możliwości pokazywanie przesyłki w zakresie "od-do"
- Rozwiązanie problemu aby powiadomienia braly informacje o przesyłce na podstawie id przesyłki a nie nazwie
- Rozwiązanie problemu z pojawiającą się informacją o paczkomacie w mailu gdy wybrana inna forma wysyłki
- Hotfix zwiazany z wysyłką po wersji 1.0.11.
- Modyfikacja powiadomień (email i strona podziękowania za zamówienie). Pokazywanie paczkomatu w tabelce.
- Dodanie akcji aby mozna było wyciągnąć dane paczkomatu do customowego powiadomienia mailowego
- 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
- Dodanie modyfikatorów wysyłki tak aby można było ustawić do wybranej kwoty oraz od wybranej kwoty.
- poprawa wczytywania skryptu JavaScript w podstronach koszyka.
- dodanie klas "btn" oraz "button" aby przycisk w koszyku wykorzystywał style szablonu.
- Dodanie pola z samym numerem paczkomatu do panelu (potrzebne do intergracji z baselinkerem).
- 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.
- Usunięcie przypadkowych znaków.
- Modyfikacja przesyłania zmiennych pomiędzy etapami.
- Usunięcie problemu z nieprawidłowymi przypisaniami paczkomatów.
- Modyfikacja przetwarzania danych w obrębie pluginu.
- Zamiana odwołań do plików.
- Zmiana permalinków.
- Dodanie ustawień na modalu.
- Dodanie ustawienia kosztów wysyłki według klas wysyłkowych.
- Dodanie możliwości wyboru paczkomatów.
- Mapka do paczkomatów w koszyku oraz checkoucie.
- Zapisywanie do panelu.
- Zapamiętywanie ostatniego wybranego paczkomatu.