dhl-poland / module-dhl

v1.0.1 2026-10-21 12:11 UTC

Requires

• php: ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• ext-intl: *
• ext-json: *
• ext-mbstring: *
• ext-soap: *
• ext-zip: *
• magento/framework: ^103.0
• magento/module-checkout: ^100.4
• magento/module-config: ^101.0
• magento/module-quote: ^101.0
• magento/module-sales: ^103.0
• magento/module-shipping: ^100.4
• magento/module-store: ^101.0

Requires (Dev)

• magento/magento-coding-standard: *
• phpunit/phpunit: ^9.5 || ^10.0 || ^12.0

MIT

• DHL eCommerce Poland

• magento
• shipping
• delivery
• parcel
• courier
• dhl
• magento2

Published on Packagist.org on 2026-10-21 12:17 UTC

README

Oficjalny moduł integracyjny DHL eCommerce (Poland) dla platformy Magento 2. Umożliwia kompleksową obsługę przesyłek kurierskich oraz dostaw do sieci punktów odbioru i automatów paczkowych (DHL POP / Parcel Locker), zarówno na terenie Polski, jak i za granicą.

Wymagania systemowe

• Magento Open Source / Adobe Commerce: 2.4.4 – 2.4.9
• PHP: 8.1 – 8.5
• Wymagane rozszerzenia PHP:
  • ext-intl
  • ext-json
  • ext-mbstring
  • ext-soap
  • ext-zip

Metody instalacji

Wtyczkę można zainstalować na dwa sposoby: za pomocą menedżera pakietów Composer (zalecane) lub ręcznie poprzez plik ZIP.

Sposób 1: Instalacja przez Composer (zalecane)

1. Pobierz moduł za pomocą Composera:

   composer require dhl-poland/module-dhl

2. Włącz moduł i zaktualizuj Magento:

   bin/magento module:enable DhlPoland_Dhl
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush

   (Uwaga: w trybie produkcyjnym należy dodatkowo wdrożyć pliki statyczne poleceniem bin/magento setup:static-content:deploy).

Sposób 2: Instalacja ręczna z pliku ZIP

1. Pobierz archiwum ZIP z najnowszym wydaniem:

   • Repozytorium wtyczki: https://github.com/DHL-eCommerce-Poland/Magento-2
   • Przejdź do sekcji Releases i pobierz plik .zip (Source code) najnowszej stabilnej wersji (najnowszego taga).

2. Przygotuj strukturę katalogów w Magento 2: W głównym katalogu swojej instalacji Magento 2 utwórz ścieżkę katalogów (jeśli jeszcze nie istnieją):

   mkdir -p app/code/DhlPoland/Dhl

3. Rozpakuj zawartość archiwum: Wypakuj zawartość pobranego archiwum ZIP do utworzonego folderu app/code/DhlPoland/Dhl/.

4. Włącz moduł i zaktualizuj Magento: W głównym katalogu Magento 2 wykonaj następujące polecenia:

   bin/magento module:enable DhlPoland_Dhl
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush

   (Uwaga: w trybie produkcyjnym należy dodatkowo wdrożyć pliki statyczne poleceniem bin/magento setup:static-content:deploy).

Konfiguracja w panelu administracyjnym

Po pomyślnej instalacji przejdź do panelu administracyjnego Magento 2:

1. Przejdź do: Sklepy (Stores) → Konfiguracja (Configuration) → Sprzedaż (Sales) → Metody dostawy (Delivery Methods / Shipping Methods) → sekcja DHL eCommerce Poland (lub bezpośrednio przez menu: Sprzedaż (Sales) → DHL eCommerce Poland → Configuration).
2. Wprowadź dane uwierzytelniające WebAPI v2 oraz dostosuj parametry usług (dostawy kurierskie, punkty odbioru POP/automaty paczkowe, ubezpieczenia, gabaryty przesyłek).
3. Zapisz konfigurację i odśwież pamięć podręczną (Cache).

Aktualizacja modułu

Przez Composer:

composer update dhl-poland/module-dhl
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

(W trybie produkcyjnym: bin/magento setup:static-content:deploy).

Przez plik ZIP:

1. Pobierz nową wersję archiwum z sekcji Releases.
2. Zastąp istniejące pliki w katalogu app/code/DhlPoland/Dhl/.
3. Wykonaj polecenia aktualizacyjne Magento (setup:upgrade, setup:di:compile, cache:flush oraz setup:static-content:deploy w trybie produkcyjnym).

Licencja

Moduł udostępniany jest na licencji MIT.