GLS PickUP Hungary
Szállítási Modul

Mit csinál?

A modul egy kereshető dropdown listát jelenít meg a pénztárban, amelyből a vásárló kiválaszthatja a kívánt GLS csomagpontot vagy automatát. A szállítási cím automatikusan a kiválasztott pont adataira cserélődik a rendelésben – az email kiküldése előtt.

• GLS parcel shop és parcel locker helyek dropdown listában, városonként csoportosítva
• A szállítási mód kizárólag akkor számít kiválasztottnak, ha konkrét pont van megjelölve – placeholder esetén a GLS nem aktív, a rendelés nem adható le ezzel a móddal
• Másik szállítási módra váltáskor a csomagpont-választás automatikusan visszaáll a placeholderre
• A rendelés leadása után a szállítási cím mezők automatikusan felülíródnak a kiválasztott pont adataival (utca, város, irányítószám, GLS azonosító)
• Beállítható szállítási költség, ingyenes küszöb, maximum súly és méret
• A csomagpont lista az admin felületről egy gombbal frissíthető a GLS API-ról
• Működik Journal3 QuickCheckout és alap OC3 pénztárban egyaránt

A modul önellátó: semmilyen checkout controller, footer vagy OCMod fájlmódosítás nem szükséges – a JS automatikusan töltődik be, ha a GLS szállítási mód elérhető.

Hogyan működik?

Pénztár folyamata (vásárlói oldal)

Cím frissítés folyamata (rendelés után)

Rendelésbe kerülő cím mezők

Adatbázis tábla (oc_z_glshu)

Event regisztráció

Az install() az alábbi rekordot írja az oc_event táblába:

Követelmények

1. Fájlok feltöltése

Töltsd fel az összes fájlt FTP / SFTP-vel a webshop gyökérkönyvtárába. A mappastruktúra megfelel a szerver struktúrájának – egyszerű 1:1 másolás.

2. OCMod frissítés

3. Aktiválás az admin felületen

4. Beállítások

5. Csomagpontok frissítése

A GLS rendszeresen frissíti a csomagpont listáját. A modul beépített frissítővel rendelkezik:

Az admin beállítások oldal alján az összes elérhető csomagpont táblázatban jelenik meg a frissítés után.

Frissítés újabb verzióra

1. Töltsd fel az új fájlokat FTP-vel (felülírja a régieket)
2. Admin → Extensions → Modifications → Refresh
3. Admin → Extensions → Shipping → GLS PickUP → Disable, majd Enable – ez újra futtatja az install()-t, ami frissíti az event regisztrációt
4. Ellenőrizd a beállításokat – az értékek megmaradnak

Eltávolítás

1. Admin → Extensions → Shipping → GLS PickUP → Uninstall (piros gomb) – törli az oc_z_glshu táblát és a glshu_order_address_fix event bejegyzést
2. Fájlok manuális törlése a szerverről (az összes feltöltött fájl)
3. Admin → Extensions → Modifications → Refresh

Hibaelhárítás

A csomagpont dropdown nem jelenik meg a pénztárban

• Ellenőrizd, hogy a modul státusza Engedélyezve
• Böngésző konzolban ellenőrizd, hogy a glshu.js betöltődött-e (Network tab)
• Ellenőrizd, hogy az oc_z_glshu táblában vannak-e sorok (Admin → Edit → csomagpont lista az oldal alján)
• A getQuote() csak akkor tölti be a JS-t, ha a GLS szállítási mód elérhető – ellenőrizd a súly/méret limiteket és a geo-zone beállítást

A rendelés szállítási cím nem frissül a csomagpont adataira

• Ellenőrizd az oc_event táblában, hogy létezik-e a glshu_order_address_fix sor
• Ha nem létezik: Admin → GLS PickUP → Disable, majd Enable
• Ellenőrizd a PHP error_log-ban, hogy van-e [GLSHU] bejegyzés rendelés leadásakor

GLS-t kiválasztva le lehet adni a rendelést csomagpont nélkül

• A GLS csak akkor számít kiválasztottnak, ha a selectben konkrét pont van (nem placeholder). Ellenőrizd, hogy a glshu.js betöltődött-e
• Ha a JS nem fut, a rejtett radio értéke a szerver által visszaadott alapértelmezett lehet – töltsd újra az oldalt és ellenőrizd az OCMod Refresh-t

„Címlista frissítése" gomb nem csinál semmit / fehér oldalt dob

• Az allow_url_fopen PHP beállítás ki van kapcsolva – engedélyezd a php.ini-ben vagy a tárhely vezérlőpultban
• Tűzfal blokkolja a map.gls-hungary.com API-t a szerver oldalon
• PHP max_execution_time lejár – az API válasz lassú lehet, növeld az időkorlátot

Telepítéskor SQL hiba / tábla nem jön létre

• Ellenőrizd, hogy az adatbázis felhasználónak van-e CREATE TABLE jogosultsága
• MySQL strict mode esetén ellenőrizd a PHP error_log-ot a pontos hibaüzenetért

Nincs jogosultságod hiba az admin mentésnél

• Admin → System → Users → User Groups → adjunk hozzá extension/shipping/glshu jogosultságot (view + modify)

Debug: event ellenőrzése adatbázisban

SELECT * FROM oc_event WHERE code = 'glshu_order_address_fix';

Ha üres az eredmény, az event nincs regisztrálva. Megoldás: Disable + Enable a modul admin felületén.

Debug: utolsó rendelések szállítási adatai

SELECT order_id, shipping_address_1, shipping_address_2, shipping_city, shipping_postcode
FROM oc_order
ORDER BY order_id DESC
LIMIT 5;

Ha a shipping_address_2 tartalmaz H1234 | GLS CityPoint formátumú adatot, az event sikeresen futott.

Fájlszerkezet

Fájlonkénti szerepek

Változásnapló