gardenlawn/trans_eu

There is no license information available for the latest version (dev-master) of this package.

Integration with trans.eu

Maintainers

Details

github.com/GARDENLAWN/trans_eu

Source

Issues

Installs: 4

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Type:magento2-module

pkg:composer/gardenlawn/trans_eu

dev-master 2026-01-14 21:22 UTC

Requires

  • php: >=8.3.0
  • ext-curl: *
  • hyva-themes/magento2-theme-module: *
  • magento/product-community-edition: ^2.4.8

Unknown License 1d0c7d0945821caa4ea06c14c26893c33dc23541

  • Rafał Piechota <marcin.piechota.woop@gardenlawn.pl>

This package is auto-updated.

Last update: 2026-01-14 21:23:05 UTC

README

Moduł integrujący sklep Magento 2 z platformą logistyczną Trans.eu. Umożliwia autoryzację OAuth2 oraz pobieranie tokenów dostępu niezbędnych do komunikacji z API Trans.eu.

Funkcjonalności

  • Autoryzacja OAuth2: Pełny proces autoryzacji (Authorization Code Grant).
  • Zarządzanie tokenami: Automatyczne pobieranie, zapisywanie i odświeżanie tokenów dostępu (access_token) oraz odświeżania (refresh_token).
  • Bezpieczeństwo: Przechowywanie kluczy API i tokenów w zaszyfrowanej formie w konfiguracji Magento.
  • Narzędzia testowe: Wbudowana strona w panelu admina do weryfikacji połączenia i stanu tokenów.

Wymagania

  • Magento 2.4.x
  • PHP 7.4+ / 8.x
  • Konto deweloperskie na platformie Trans.eu (Client ID, Client Secret, API Key).

Instalacja

  1. Skopiuj pliki modułu do katalogu app/code/GardenLawn/TransEu.
  2. Uruchom polecenia instalacyjne: 
    bin/magento module:enable GardenLawn_TransEu
bin/magento setup:upgrade
bin/magento cache:clean

Konfiguracja

  1. Zaloguj się do panelu administracyjnego Magento.
  2. Przejdź do Stores > Configuration > GardenLawn > Trans.eu Integration.
  3. Wprowadź dane otrzymane od Trans.eu:
    • Client ID
    • Client Secret
    • API Key
    • TransId (opcjonalnie, dla celów informacyjnych)
  4. Upewnij się, że adresy URL są poprawne (domyślnie dla środowiska produkcyjnego):
    • Auth URL: https://auth.platform.trans.eu
    • API URL: https://api.platform.trans.eu
  5. Skonfiguruj Redirect URI:
    • Wpisz adres: https://twoja-domena.pl/trans_eu (lub https://twoja-domena.pl/delivery/index/index jeśli nie używasz routingu trans_eu).
    • Ważne: Ten sam adres musi być dodany w ustawieniach Twojej aplikacji w panelu deweloperskim Trans.eu.
  6. Zapisz konfigurację (Save Config).

Użycie (Autoryzacja)

  1. Po zapisaniu konfiguracji, w sekcji Trans.eu Integration kliknij przycisk Authorize.
  2. Zostaniesz przekierowany na stronę logowania Trans.eu.
  3. Zaloguj się i potwierdź dostęp.
  4. Po pomyślnej autoryzacji zostaniesz przekierowany z powrotem do sklepu, a tokeny zostaną zapisane w tle.

Weryfikacja i Testy

Moduł udostępnia narzędzie do sprawdzania stanu połączenia:

  1. W panelu admina przejdź do Sales > Operations > Trans.eu API Test.
  2. Strona wyświetli:
    • Status konfiguracji.
    • Aktualnie zapisane tokeny i czas ich wygaśnięcia.
    • Wynik próbnego pobrania tokenu (co automatycznie przetestuje mechanizm refreshToken, jeśli token wygasł).

Alternatywnie, możesz użyć skryptu w przeglądarce (jeśli został utworzony w pub/): https://twoja-domena.pl/test_trans_eu.php

Logi

Szczegółowe logi z procesu wymiany tokenów znajdują się w pliku: var/log/system.log (lub debug.log w zależności od konfiguracji loggera). Szukaj wpisów rozpoczynających się od Trans.eu.