Paczkomaty InPost dla OpenCart 4

Standardowy OpenCart 4 nie oferuje jeszcze natywnej integracji z mapą InPost, co sprawia, że użytkownicy muszą ręcznie podawać dane paczkomatu lub korzystać z zewnętrznych, często płatnych rozwiązań.

W odpowiedzi na ten brak, przygotowaliśmy dwa w pełni darmowe rozszerzenia, które dodają do sklepu oficjalny widget mapy InPost i zapisują wybrany punkt w zamówieniu – bez konieczności modyfikowania rdzenia systemu. To dobry przykład, jak przemyślane projektowanie sklepu internetowego upraszcza proces zakupowy, zmniejsza liczbę błędów i realnie poprawia doświadczenie użytkownika na etapie dostawy.

Rozszerzenia są dostępne w dwóch wariantach:

DC Paczkomaty Płatność Online (dc_paczkomaty_po) – dla przesyłek opłaconych z góry (np. PayU, Przelewy24, Tpay).

DC Paczkomaty Płatność za Pobranie (dc_paczkomaty_cod) – dla wysyłek z płatnością przy odbiorze.

 

Takie rozdzielenie pozwala w pełni wykorzystać możliwości modułów typu Ship2Pay, które umożliwiają powiązanie metod wysyłki z określonymi formami płatności. Dzięki temu kupujący widzi tylko te opcje, które mają sens w danym kontekście — np. „Paczkomaty Online” przy płatności elektronicznej, a „Paczkomaty za Pobranie” tylko przy płatności przy odbiorze.

Oba moduły działają niezależnie, więc można włączyć jeden lub oba równocześnie — w zależności od potrzeb sklepu.
Do poprawnego działania wymagany jest VQMod, który umożliwia bezpieczne wstrzyknięcie kodu bez naruszania plików rdzeniowych systemu. Szczegóły instalacji tego narzędzia opisujemy w dalszej części.

Poszerz wiedzę: Jakich metod wysyłki używać w sklepie internetowym?

 

Dlaczego VQMod jest potrzebny w OpenCart 4

Wraz z premierą OpenCart 4 wprowadzono szereg zmian w strukturze systemu, które miały zwiększyć bezpieczeństwo i stabilność sklepu. Jednym z efektów ubocznych tych zmian jest jednak ograniczenie możliwości wstrzykiwania kodu PHP do kluczowych kontrolerów — na przykład tych obsługujących proces zamówienia (checkout/checkout.php czy checkout/confirm.php).

W praktyce oznacza to, że AJAX z poziomu frontendu (np. z mapy InPost) nie może już bezpośrednio komunikować się z własnymi kontrolerami umieszczonymi w folderze extension/. Takie żądania są po prostu blokowane przez system.

Tutaj z pomocą przychodzi VQMod — narzędzie, które umożliwia dynamiczne i bezpieczne „rozszerzanie” istniejących plików rdzeniowych bez ich modyfikowania. Dzięki niemu można np. dodać własną metodę w checkout/checkout.php albo dopisać dane paczkomatu do komentarza zamówienia w checkout/confirm.php, a wszystko to bez naruszania oryginalnych plików systemu.

To rozwiązanie ma kilka istotnych zalet:

• ✅ Kompatybilność z aktualizacjami OpenCart – modyfikacje VQMod działają warstwowo i nie są nadpisywane podczas aktualizacji.

• ✅ Stabilność – nie trzeba korzystać z systemu eventów, który w OC4 bywa niestabilny i nie zawsze działa poprawnie w kontekście metod AJAX.

• ✅ Bezpieczeństwo – wszystkie zmiany są odwracalne, a oryginalne pliki pozostają nietknięte.

Dlatego moduły DC Paczkomaty wymagają VQMod — to jedyny sposób, aby zachować pełną integrację z procesem zamówienia w OpenCart 4 bez ryzyka błędów i konfliktów z innymi rozszerzeniami.

 

⚙️ Instalacja VQMod w OpenCart 4

Aby moduły DC Paczkomaty mogły działać prawidłowo, wymagane jest zainstalowanie VQMod — lekkiego systemu modyfikacji, który umożliwia wstrzykiwanie kodu bez edycji plików rdzeniowych. Instalacja jest szybka i jednorazowa, a po jej wykonaniu VQMod działa automatycznie dla całego sklepu.

 

🔽 Krok po kroku

1. Pobierz najnowszą wersję VQMod dla OpenCart 4:
👉 https://github.com/vqmod/vqmod

W repozytorium znajduje się także wersja kompatybilna z różnymi strukturami katalogów — przydatna zwłaszcza wtedy, gdy Twój folder administracyjny ma niestandardową nazwę (np. admindc zamiast admin).

 

2. Wypakuj i wgraj pliki
Skopiuj zawartość paczki VQMod bezpośrednio do katalogu głównego sklepu, np.:

Po wgraniu powinien pojawić się folder /vqmod/ oraz plik vqmod/install/index.php.

 

3. Uruchom instalator w przeglądarce:

Jeśli wszystko przebiegło pomyślnie, zobaczysz komunikat:

5. Konfiguracja dla niestandardowego katalogu admina (OpenCart 4)
Jeśli Twój panel administracyjny nie znajduje się w domyślnym katalogu admin (np. używasz /admindc/), wystarczy:

• otworzyć plik vqmod/install/index.php,

• dopisać w nim nazwę katalogu administracyjnego w miejscu konfiguracji (np. $vqmod->setAdminFolder('admindc');),

• uruchomić instalator ponownie.

 

6. Gotowe!
Po instalacji VQMod działa automatycznie — nie wymaga żadnej aktywacji ani konfiguracji w panelu OpenCart.
Od tej chwili wszystkie pliki .xml umieszczone w folderze /vqmod/xml/ będą ładowane przy każdym uruchomieniu sklepu.

 

🟡 Instalacja modułów DC Paczkomaty

Integracja z mapą InPost w OpenCart 4 wymaga dwóch rozszerzeń – osobnych dla każdej formy płatności.
Wszystko jest gotowe do użycia – wystarczy rozpakować, wgrać i zainstalować.

 

📦 1. Pobierz paczki ZIP

Pobierz z naszego repozytorium dwa archiwa:

• dc_paczkomaty_po.zip – paczkomaty z płatnością online

• dc_paczkomaty_cod.zip – paczkomaty z płatnością za pobraniem

💡 Oba moduły działają niezależnie — możesz włączyć tylko jeden lub oba.

 

🧩 2. Rozpakuj archiwum lokalnie

Po rozpakowaniu każdego ZIP-a zobaczysz:

📁 3. Skopiuj folder vqmod/ na serwer

Wgraj cały folder vqmod/ z paczki do katalogu głównego Twojego sklepu, np.: 

System połączy zawartość z istniejącym katalogiem vqmod/.
Nie kopiuj pojedynczych plików do vqmod/xml/ — wrzuć cały folder.

⚠️ Jeśli pojawią się błędy zapisu, ustaw uprawnienia:
chmod -R 777 vqmod/

 

⚙️ 4. Zainstaluj OCMOD przez panel administracyjny

1. Wejdź w Rozszerzenia → Instalator

2. Kliknij Prześlij i wybierz odpowiedni plik:

   • dc_paczkomaty_po.ocmod.zip

   • dc_paczkomaty_cod.ocmod.zip

3. Po zainstalowaniu przejdź do Rozszerzenia → Modyfikacje

4. Kliknij 🔄 Odśwież, aby aktywować zmiany

 

🚚 5. Włącz metody wysyłki

Panel → Rozszerzenia → Dostawa
Znajdziesz dwie nowe pozycje:

• 📦 Paczkomaty – płatność online

• 💰 Paczkomaty – płatność za pobraniem

Włącz i skonfiguruj każdą z nich (np. koszt, status, strefę).
Możesz też połączyć je z modułem Ship2Pay, aby przypisać płatności do odpowiednich metod dostawy.

 

🔍 6. Sprawdź na stronie sklepu

1. Dodaj produkt do koszyka i przejdź do zamówienia (checkout)

2. Wybierz metodę wysyłki Paczkomaty…

3. Pojawi się przycisk „Wybierz paczkomat”

4. Wybierz punkt z mapy InPost

5. Wybrany paczkomat zostanie zapisany w komentarzu zamówienia, widocznym w panelu administratora.

Gotowe! 🎉
Od teraz Twój sklep obsługuje paczkomaty InPost zarówno dla płatności online, jak i za pobraniem — w pełni zgodnie z OpenCart 4 i bez modyfikacji plików rdzeniowych, dzięki VQMod.

 

🧩 Konfiguracja i działanie

Po poprawnej instalacji i odświeżeniu modyfikacji wystarczy kilka kroków, aby moduł działał w pełni:

 

⚙️ 1. Ustawienia w panelu administracyjnym

Przejdź do Rozszerzenia → Dostawa, a następnie:

• Włącz moduł Paczkomaty – płatność online lub Paczkomaty – płatność za pobraniem,

• Ustal stawki za wysyłkę, status, oraz – jeśli chcesz – ogranicz metodę do określonych stref geograficznych.

💡 Możesz włączyć tylko jeden moduł lub oba – działają niezależnie.

 

🖥️ 2. Działanie po stronie klienta

Na stronie zamówienia (checkout) klient po wybraniu metody Paczkomaty zobaczy przycisk:
„Wybierz paczkomat”.

Kliknięcie otwiera mapę InPost (widget geolokalizacyjny), z której klient wybiera dogodny punkt odbioru.

 

📋 3. Zapis wybranego paczkomatu

Po wyborze punktu dane paczkomatu (kod, adres, ewentualny opis lokalizacji) są:

• zapisywane w sesji klienta,

• automatycznie dopisywane do komentarza zamówienia,

• widoczne w panelu administracyjnym przy szczegółach zamówienia.

Przykład zapisu w komentarzu:

📦 Paczkomat: WAW01A (ul. Marszałkowska 10, Warszawa) przy wejściu do centrum handlowego

 

🔄 4. Zmiana metody dostawy

Jeśli klient w trakcie zamówienia zmieni metodę wysyłki (np. z Paczkomatu na Kuriera DHL),
system automatycznie pomija zapisane dane paczkomatu, aby nie były błędnie powiązane z inną formą dostawy.

 

 

🔄 Współpraca z Ship2Pay

 

💡 Czym są moduły typu Ship2Pay?

Ship2Pay to rozszerzenia, które pozwalają powiązać konkretne metody dostawy z wybranymi metodami płatności.
Dzięki nim klient zobaczy tylko te opcje płatności, które faktycznie mają sens dla danego sposobu wysyłki.

 

⚙️ Dlaczego rozdzieliliśmy moduły DC Paczkomaty

Właśnie z myślą o takiej integracji przygotowaliśmy dwa osobne moduły:

• 📦 dc_paczkomaty_po – dla metod płatności online (np. PayU, Przelewy24, Blik)

• 💰 dc_paczkomaty_cod – dla przesyłek pobranowych (COD – Cash on Delivery)

 

🔗 Jak to działa w praktyce

W module Ship2Pay możesz ustawić prostą logikę:

Dzięki temu klient nie pomyli form płatności, a proces zakupowy pozostaje czytelny i intuicyjny.

 

✅ Korzyści z rozdzielenia modułów

• pełna zgodność z Ship2Pay i podobnymi rozszerzeniami,

• większa kontrola nad procesem zakupowym,

• brak ryzyka, że klient wybierze płatność online przy przesyłce pobraniowej,

• możliwość różnicowania cen wysyłki i opisów metod w zależności od typu płatności.

 

🧾 Podsumowanie

Moduły DC Paczkomaty to proste, darmowe i w pełni zgodne z OpenCart 4 rozwiązanie umożliwiające integrację sklepu z mapą InPost.
Zaprojektowane zostały z myślą o praktyczności i bezproblemowej instalacji – zero kodowania, pełna automatyzacja.

✅ Najważniejsze zalety

• ⚙️ Działają stabilnie dzięki VQMod – bez żadnej ingerencji w pliki rdzeniowe.

• 📦 Dwa osobne moduły (online i COD) zapewniają pełną kompatybilność z systemami typu Ship2Pay.

• 🚀 Instalacja w kilka minut – wystarczy rozpakować, wgrać, zainstalować i odświeżyć modyfikacje.

• 🔒 Bezpieczne rozszerzenie – wszystkie zmiany są wykonywane poza strukturą plików systemowych.

• 💡 Przyjazne dla użytkownika – klient wybiera paczkomat jednym kliknięciem, a dane są automatycznie zapisywane w zamówieniu.

 

Dzięki tym rozszerzeniom Twój sklep zyskuje pełną integrację z InPostem – zarówno dla płatności online, jak i pobraniowych –
zachowując przy tym czystość kodu i stabilność aktualizacji OpenCart 4.

To rozwiązanie sprawia, że sklep działa jak duży e-commerce — automatycznie dopasowuje metody płatności do rodzaju dostawy, bez potrzeby tworzenia skomplikowanych reguł.