Magento 2

Modul letöltése és telepítése

1. Telepítés előtt győződj meg róla, hogy webshop-od megfelel az alábbi kritériumoknak:
   • Legalább Magento 2.4-es verzióval rendelkezel
   • PHP verzió legalább 8.1
   • Telepítve van composer csomagkezelő
   • Telepítve vannak a következő Magento 2 modulok:
     • magento/module-config
     • magento/module-shipping
     • magento/module-payment
     • magento/module-sales
     • magento/module-backend
     • magento/module-inventory
   • Magyar nyelv használatához telepítve van a bármilyen hu_HU nyelvet biztosító nyelvi modul pl.: https://github.com/mageplaza/magento-2-hungarian-language-pack
   • bin/magento parancs futtatható a Magento 2 telepítési mappájában
2. Telepítéshez először add hozzá az Zenit csomagokhoz tartozó repostiry-t a következő paranccsal composer config repositories.10147552 composer https://gitlab.com/api/v4/group/10147552/-/packages/composer/packages.json
3. Ezt követően lehetőséged lesz megfuttatni a composer require zenit-kft/ilogistic-magento-integration parancsot, itt célszerű a fix verizókkal jelölt csomagokat telepíteni, tehát ^1.0 vagy ^2.0, az instabil teszt verzió telepíthető a dev-master tag alatt, ami bár instabil, esetenként sokkal előrébb jár javítások/feature-ök terén mint a stabil verziók
4. Telepítést követően futtasd le a bin/magento se:up parancsot, hogy a Magento webshop-od megtalálja az iLogistic plugin-t
5. Ezt követően futtasd meg a bin/magento c:c parancsot a gyorsítótárak ürítéséhez
6. Amennyiben a fentebbi lépések sikeresek voltak webáruházadban elérhetőnek kell lennie az iLogistic beállításainak
7. Miután legalább egy Magento store-odon bekapcsoltad és kitöltötted az iLogistic beállításait, futtasd meg a bin/magento ilogistic:product-sync parancsot, ami minden beállított store termékeit feltölti az iLogistic fiókodba (Ez a parancs a későbbiekben is használható! Paraméterként megadható neki a store-ok pontos azonosítói is.)
8. A module maga ki- és bekapcsolható globálisan és per website egyaránt az iLogistic beállításaiban. A rendelés szinkron csak a bekapcsolt website-okon funkcionál.
9. A plugin default beállításain felül (amit kötelező kitölteni, hiszen a termék szinkron ebből dolgozik), a teszt üzemmód és a teljes működés szabadon ki-be kapcsolható, minden beállítás módosítható per website.

A modul működése

• A modul nagyrésze cronjob-okra (időzített műveletekre) épít. Ezekből összesen 5 darab található a modulban, mind az ilogistic cron csoport (cron-group) alatt.
  • token_refresh ami a beírt API kulcs automatikus frissítésére szolgál. (Ez minden nap éjfélkor fut.)
  • stock_update ami a Magento boltodban lévő termékek készlet frissítésére való (Ez minden 1 órában lefut.)
  • order_status ami a Magento boltodban lévő ilogistic_id tulajonsággal rendelkező rendeléseid státuszát frissíti a beállításokatban megfeleltetett státuszoknak (Ez minden 5 percben lefut.)
  • order_create ami a Magento boltodban lévő ilogistic_id tulajdonsággal nem rendlekező rendeléseid küldi el automatikusa az iLogistic fiókodba (Ez minden 5 percben lefut.)
  • product_sync a fentebbi lépésben említett bin/magento ilogistic:product-sync parancsot futtatja meg automatikusan (Minden 24 órában lefut.)
• Modulunk másik nagyon fontos eleme a sales_order_place_after eseményre iratkozik fel, ami az ügyfél és admin oldali rendelés létrehozása automaitkusan meghívja a modul egy részét, ami ezt a rendelést feltölti az iLogistic fiókodba
• Telepítéskor létrehozunk egy ilogistic_id tulajdonságot minden rendelésben, ebben tároljuk a feltöltött rendelések iLogistic-től kapott azonosítóját később státusz frissítésekhez
• Modulunk fejlesztésénél kiemelt figyelmet fordítottunk a pontos és precíz naplózásra, ezért minden fentebb írt műveletről napló bejegyzés készül a Magento webáruház alapértelmezett log mappájába (jellemzően: var/log/ mappa) egy ilogistic.log nevű fájlba
• Csatalkozás mind a teszt mind az éles környzetre lehetséges, ez beállítható az beépülő megállításaiban, globális (default) és lokális (website) szinten egyaránt. (Ebben az esetben a megfelelő környezetben generált token szükséges!)
• A rendszer minden átadott rendeléshez rögzített rendelési értékről alapértelmezetten feltételezi, hogy a webáruházban rögzített és/vagy átadott érték az adott ország hivatalosan elfogadott devizanemében került rögzítésre. A rendszer devizanemek közötti átváltást nem végez, így az utánvétes rendelések esetén az adott rendeléshez rögzített értéket változatlanul adja tovább a futárcégeknek a rendelés kiszállítása során beszedendő utánvét összegként.
• A készletek az ilogistic_source készlet forrás alá lesznek rögzítve, ebben a készlet forrásban tartja napra készen az iLogistic-el kapcsolatos készletet a Magento áruházad.

Event-ek

• ilogistic_order_status_update_before a rendelés státusz frissítése után, de mentés előtt kerül elküldésre, paramétere a frissített rendelés (order)
• ilogistic_order_status_update_after a rendelés státusz frissítése után, mentés után kerül elküldésre, paramétere a frissített rendelés (order)
• ilogistic_token_update_before a token frissítése után, de mentés előtt kerül elküldésre, paramétere az új token (token) és a store melyben a storeId található
• ilogistic_token_update_after a token frissítése után, mentés után kerül elküldésre, paramétere az új token (token) és a store melyben a storeId található