Woocommerce plugin
Plugin letöltése, telepítése:
Telepítés előtt győződjön meg róla, hogy webshop-ja megfelel az alábbi kritériumoknak:
- Woocommerce WordPress plugin 4.0.0 és 6.6.1 verzió között van
- PHP verzió legalább 8.0
- Írási jog a WooCommerce log mappájához (általában a
/var/www/html/wp-content/uploads/wc-logs/mappa) - Időzített műveletek (cronjob-ok) ne legyenek letiltva a Wordpress konfigurációjában
- Regisztrált és adminisztrátor által jóváhagyott iLogistic fiók
- Regisztrált és adminisztrátor által aktivált iLogistic cég
A plugin verziók az alábbi linken elérhetőek, vagy a webshop-od Bővítmények menüpontja alatt telepíthető.
A plugin telepítéséhez válasszuk ki a „Bővítmények” menüpontot.
A bővítmények menüponton belül az „Új hozzáadása” opciót.
Miután kiválasztottuk az „Új hozzáadása” opciót, a jobb oldalon lévő keresőbe kell beírnunk az „iLogistic” szót.
A listázást követően az „iLogistic Fulfillment WooCommerce Plugin” telepítését válasszuk ki, kattintsunk a „Telepítés most” gombra.
A telepítés után a „Bekapcsolás” gombra kattintva tudjuk aktiválni a plugint.
Tokent az iLogistic rendszerében a WooCommerce ikonra kattintva generálhatunk. Itt szükséges megadni az email címet, valamint a jelszavát a felhasználónak (az iLogistic rendszerében használtakat) majd rákattintani az API token generálása gombra. Amennyiben az adatok megfelelőek, a beviteli mezők alatt megjelenik a szükséges token. Kérjük ügyeljen arra, hogy a token teljes hosszát másolja ki. API token generálásra óránként egyszer van lehetőség felhasználónként.
A plugin beállításait az alábbi módon érheti el:
- A plugin mellett található
Beállításokfeliratra kattintva - A WooCommerce beállítások oldalon az iLogistic fülre kattintva
- A legfontosabb beállítások a státuszok, illetve a fizetési és szállítási módok megfeleltetése. Az "iLogistic státusz beállítások" pont alatt láthatóak bal oldalon az iLogistic által használt státuszok, ezekhez kell hozzárendelni a WooCommerce által használt státuszokat. Tehát ami nálunk "Jóváhagyva/Jóváhagyásra vár", az a belépő státusz és minden, ehhez megfeleltetett státuszú rendelés WooCommerce-ből be fog jönni az iLogistic rendszerébe (itt nagyon fontos, hogy csak olyan rendelések legyenek ebben a státuszban az integrációnál, amit valóban mi fogunk kiszállítani). Ezután ahogy halad a rendelés a státuszaink közt, úgy fog szinkronizálódni WooCommerce-ben is. Van lehetőség több belépő státuszt is megadni.
- A fizetési és szállítási módok megfeleltetésénél arra kell figyelni, hogy minden esetben karakterre pontosan ugyanaz a szöveg legyen beillesztve a pluginunk beállításaihoz, mint ami a WooComerce szállítási és fizetési módjainál. Amennyiben egy vagy több szöveg is megjelenik a mód neve mellett, abban az esetben a szürkét írja a megfelelő mezőbe, ne pedig a kékkel megjelenőt!
- NAGYON FONTOS arra ügyelni, hogy a fizetési és szállítási módok elnevezésében ne szerepeljen
,karakter, mivel a plugin ezt a karaktert használja az elválasztásra, hogy több fizetési/szállítási módot is lehessen használni.
- A plugin mellett található
Amennyiben ezeket a beállításokat elvégeztük és mentettük, a plugin működése meg is kezdődött!
A plugin működése
Csomagpontos szállítás esetében a pluginünk csak és kizárólag az alábbi plugin-okkal kompatibilis, kérjük mindenképp ezek közül valamelyiket telepítse, amennyiben csomagpontos (GLS, Foxpost stb.) szállítást szeretne használni:
A fentebb látható lépések elvégeztével a plugin minden cikkszámmal rendelkező terméket elküld az iLogistic rendszerének.
Minden utólag felvett termék szintén átkerül az iLogistic rendszerébe, amennyiben az rendelkezik cikkszámmal.
- A termékek akkor számítanak új terméknek, amennyiben cikkszáma nem szerepel az iLogistic rendszerében.
- Azok a pluginok, amelyek automatikusan módosítják/kiegészítik az újonnan létrehozott termékeket azt eredményezhetik, hogy a termék többször kerül elküldésre az iLogistic rendszere felé.
A plugin bekötését követően minden a Jóváhagyva státusznak megfeleltetett állapotú rendelés, melyek termékei szereplenek az iLogistic rendszerében elküldésre kerülnek az iLogistic felé. Az ezt követően újonnan leadott megrendelésekre alapértelmezetten az iLogistic 5 percenként kérdez be.
- Amennyiben egy rendelés nem jön létre az iLogistic rendszerében, érdemes ellenőrizni a napló fájlokat (logokat).
A plugin saját iLogistic nevű log fájlt hoz létre mely tartalmazza a plugin nevét, az adott napot,
és a hiba okát vagy a rendelés beküldéséhez szükséges teendőt.
A naplófájlok között a beépülő, saját iLogistic nevű log fájlt hoz létre mely tartalmazza a plugin nevét, az adott napot, és hash-t.
- A logokat a plugin telepítése/aktiválása után, valamint új termék felvétele után ajánlott ellenőrizni, hogy minden termék megfelelően bekerült-e az iLogistic rendszerébe.
- Általános hiba, nem sikerült beküldeni a rendelést.
- Megoldás: A rendelés tulajdonságaiba lépve az ilogisitc_ID mező törlése.
- Hibás szállítási móddal leadott rendelés.
- Megoldás: A rendelésben megadott szállítási mód megfeleltetése.
- Hibás fizetési móddal leadott rendelés.
- Megoldás: A rendelésben megadott fizetési mód megfeleltetése.
- Rendelésben szereplő termék nem rendelkezik cikkszámmal.
- Megoldás: A termék cikkszám megadása.
- A rendelésben szereplő termék nincs rögzítve az iLogistic rendszerben.
- Megoldás: A termék létrehozása az iLogistic rendszerében.
- Amennyiben egy rendelés nem jön létre az iLogistic rendszerében, érdemes ellenőrizni a napló fájlokat (logokat).
A plugin saját iLogistic nevű log fájlt hoz létre mely tartalmazza a plugin nevét, az adott napot,
és a hiba okát vagy a rendelés beküldéséhez szükséges teendőt.
Amennyiben a rendelés adatai/termékei módosulnak azt a plugin elküldi az iLogistic rendszerének 5 percenként, ahol a rendelés szintén módosul, amennyiben annak csomagolása még nem kezdődött meg.
A plugin minden rendelésre, mely nem törölt, vagy teljesített 5 percenként visszakérdez az iLogistic rendszerébe, hogy ezek státusza változott-e és a beállításokban megadottak szerint frissíti ezeket a WooCommerce shopban.
Amennyiben egy rendelés törlésére kerül sor (Lomtárba helyezés még nem minősül ennek) a plugin ezt jelzi az iLogistic rendszerében, ahonnan a rendelés szintén törlésre kerül, amennyiben annak elkészítése még nem kezdődött meg.
Abban az esetben, ha az iLogistic felületén a "Szabályok" menüpont alatt be van kapcsolva a "Készletszint módosulás küldése webshop felé" funkció, illetve a WooCommerce webshop-ban termékenként engedélyezve van a készlet szinkronizáció, a beépülő modul ezeknek a készletet 5 perces periódusokban frissíti az aktuális raktárkészlet állásra. Itt nagyon fontos tehát, hogy csak abban az esetben legyen bekapcsolva ez a funkció, ha minden, az iLogistic rendszerében lévő termék készletszintjét szinkronizálni akarjuk a WooCommerce webshop készleteivel.
| iLogistic funkció | WooCommerce plugin |
|---|---|
| Rendelésben termék módosítás + termék | IGEN |
| Rendelésben termék módosítás - termék | IGEN |
| Rendelésben végösszeg módosítás | IGEN |
| Rendelésben szállítási mód módosítás | IGEN |
| Rendelésben fizetési mód módosítás | IGEN |
| Rendelésben szállítási cím módosítás | IGEN |
| Rendelésben számlázási cím módosítás | IGEN |
| Rendelés törlés | IGEN (lomtárból törlés esetén) |
| Termék módosítás - név | NEM |
| Termék módosítás - ár | NEM |
| Termék törlés (nincs készleten) | NEM (lomtárból törlés esetén sem) |
| Termék törlés (van készleten) | NEM (lomtárból törlés esetén sem) |
| Termék törlés (már volt készleten) | NEM (lomtárból törlés esetén sem) |
Egyéb tudnivalók
- A plugin használatához elegendő az első telepítéskor/aktiváláskor manuálisan tokent kérni. A tokenek 7 napig érvényesek, ám ha a plugin aktiválva van, azesetben 2 naponta automatikusan igényel magának új tokent.
- A plugin forráskódjának módosítása vagy nem verziószámozott bővítmény használata esetén a license-ben foglaltak szerint nem vállalunk felelősséget semmilyen felmerülő probléma miatt.
- A plugin megfelelő működéséhez kérjük mindig a legfrisebb verziót használja.
- Amennyiben új verzió kerül kiadására, arról minden WooCommerce-el rendelkező ügyfelet emailen keresztül értesítünk.
- Abban az esetben ha a Wordpress bővítmény kezelőjén keresztűl lett feltelepítve a plugin, akkor automatikusan frissűl a legújabb verzíóra ha engedélyezve van az automatikus frissítése a bővítménynek.
- A termékek módosulását illetve törlését a plugin nem küldi el az iLogistic rendszerének, ezért ha azt törölni/módosítani kívánja, kérjük tegye meg az iLogistic rendszerében szintén.
- Rendelés onnan minősül töröltnek, hogy az a lomtárból is eltávolításra került.
- Amennyiben a naplófájlok helyén a
Jelenleg nincsenek megtekinthető naplófájlok.felirat található ellenőrizze, hogy írható-e a WooCommerce naplófájlok mappája. Ez a <webshoplint>/wp-admin/admin.php?page=wc-status oldalon található aWordPress környezettáblázat 8. sorában találhatóA naplófájl könyvtára írható:felirat mellett. - Amennyiben egy rendelés státuszának egy végstátusz került beállításra, abban esetben nem lehet további státusz módosítást végrehajtani. Ezek a státuszok: Visszárú és Kiszállítva
- 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.