R2R WITHDRAWAL · JOOMLA + HIKASHOP

R2R Withdrawal dokumentáció

Telepítés, beállítások és napi ügyintézés. Az útmutató az 1.14.8-as csomag működését mutatja be.

Mire való az R2R Withdrawal?

A bővítmény a HikaShop-rendelésekhez kapcsolódó elállási nyilatkozatokat és azok ügyintézését kezeli. A vásárló a webshopon azonosítja a rendelését, kiválasztja az érintett tételeket, majd áttekinti és megerősíti a nyilatkozatot. Az elállás külön ügyként jelenik meg a Joomla adminban.

A csomag egy komponenst, egy közös könyvtárat, két plugint és egy adminmodult telepít. Nem kell Joomla- vagy HikaShop-alapfájlokat átírni. A pénzügyi visszautalást nem végzi el, és a HikaShop-rendelés státuszát nem módosítja.

Telepítés és első indítás

Készíts mentést, és először tesztoldalon telepíts. A követelmények és a már kipróbált verziópárosítások a kompatibilitási táblázatban szerepelnek. PHP 8.1 vagy újabb szükséges.
A Joomla Rendszer → Telepítés → Bővítmények oldalán töltsd fel a teljes pkg_r2r_withdrawal-…zip fájlt. A belső ZIP-eket nem kell külön telepítened.
A Rendszer → Pluginok alatt engedélyezd a System – R2R Withdrawal és az Ajax – R2R Withdrawal plugint.
A rendszerpluginban add meg a webshop nevét és az értesítési e-mail-címet. Több címet vesszővel, pontosvesszővel vagy külön sorban is megadhatsz.
Hozz létre publikált, nyilvánosan elérhető menüpontot az Elállási nyilatkozat (wizard) típusból. Az elallas alias például a /elallas útvonalat adja.
A Komponensek → Elállások → Súgó és ellenőrzés oldalon futtasd le az ellenőrzést, majd küldj be egy tesztnyilatkozatot vendégként és bejelentkezve is.

A menüpont hivatkozását a látogatók számára könnyen megtalálható helyen jelenítsd meg. Ha a HikaShop gyári elállási folyamatát is használod, ellenőrizd, hogy nem jelenik-e meg két eltérő belépési lehetőség. Az R2R saját ügyeket tart nyilván, nem közös listát a gyári funkcióval.

A rendszerplugin beállításai

A webshophoz igazítható értékeket a System – R2R Withdrawal pluginban találod. Mentés után ellenőrizd a változást a vásárlói oldalon is.

Beállítás	Mire használható?
Webshop neve és admincímek	Az e-mailekben használt név és a beérkező elállásokról értesítendő címzettek.
A vásárlói felület színei	Kiemelőszín, fő szövegszín, a kiemelőszínen látható szöveg és a linkek színe. Olyan párosítást válassz, amely minden állapotban jól olvasható.
Elállási határidő napokban	Alapértéke 14. Az 1.14.8-as csomagban az ellenőrzés nem kap tényleges átvételi dátumot, ezért a mező nem jelent automatikus, átvételtől számított lejáratblokkolást. A határidőt az ügyintézőnek is ellenőriznie kell.
Elállási azonosító	Például `EL-{YYYY}-{NNNNNN}`. A `{YYYY}` négyjegyű évet, `{YY}` kétjegyű évet, `{MM}` hónapot jelöl. Az N-ek száma a sorszám minimális hossza. Pontosan egy sorszámjelölő kell. A már kiosztott azonosítók nem változnak; a környező minta változásával új számsor indulhat.
HikaShop-gombok	A rendeléskártya fejlécében, a Lehetőségek menüben vagy mindkettőben jelenhetnek meg. A Ki beállítás a rendeléskártya-gombokat kapcsolja ki; a fiókmenü belépési pontja megmarad. Egyedi HikaShop-sablonnal ellenőrizd a tényleges megjelenést.

Lépésenkénti tájékoztató szövegek

A Wizard szövegek fülön a rendelés azonosítása, a tételválasztás, az összefoglaló és a megerősítés elé és mögé is írhatsz saját szöveget. A sikeres beküldés oldalához szintén két mező tartozik: összesen tíz helyen adhatsz útmutatást.

Üres mezőnél ott nem jelenik meg kiegészítő szöveg. Alap HTML-formázás használható, például bekezdés, kiemelés, lista és hivatkozás; a veszélyes elemeket a mentés szűri. Ezek webshoponkénti tartalmak: a magyar és angol nyelvi fájlok megléte nem fordítja le automatikusan a saját szövegedet.

E-mail-sablonok és értesítések

Három külön sablon szerkeszthető: ügyfél-visszaigazolás, adminértesítés és állapotváltozási levél. HTML-t is használhatsz. Üresen hagyva a mezőt a beépített sablon érvényesül. Az értesítésekhez a Joomla levelezésének működnie kell; a tesztelés része legyen a tényleges postafiók ellenőrzése.

Sablon	Használható helyőrzők
Mindhárom sablon	`{withdrawal_number}`, `{order_id}`, `{customer_name}`, `{items}`, `{submitted_at}`, `{shop_name}`
Állapotváltozási sablon, ezen felül	`{status_label}`, `{admin_message}`, `{refund_amount}`, `{refund_info}`

A helyőrzőket kapcsos zárójelekkel együtt másold be. A visszaigazolásból ne hagyd ki az érintett tételeket, az azonosítót és az időpontot. Az egyedi levélszövegeket a webshop nyelvéhez és tájékoztatásához igazítsd.

Adatvédelem és azonosítási védelem

Az IP-cím mentése alapértelmezetten be van kapcsolva; a böngészőazonosító (User-Agent) mentése nincs. Ezek külön kapcsolhatók. A technikai adatok megőrzése alapértéken 365 nap, 0 esetén nincs ilyen automatikus törlés. A lezárt ügyek érintett adatainak takarítása az adminisztrációs lista megnyitásakor fut le, nem külön időzített feladatként.

A sikertelen rendelésazonosítások IP-címenként és rendelésszámonként is korlátozhatók. Az alapérték 10, illetve 5 próbálkozás, 15 perces időablakban. Ez a webshopos rendelésazonosítás védelme; nem a regreen weboldal letöltésszámlálója.

A saját adatkezelési tájékoztatód a tényleges beállításokat írja le. Az adatok a webshopod tárhelyén maradnak; az R2R nem küldi el nekem a vásárlóid nyilatkozatait.

A vásárlói folyamat

Rendelés azonosítása. Bejelentkezve a saját rendeléseiből választ. Vendégként a rendelés hivatkozását és az ahhoz tartozó e-mail-címet adja meg.
Tételek és mennyiségek. Teljes vagy részleges elállást is jelezhet. A rendszer figyelembe veszi a korábban elállás alá vont mennyiségeket; egy rendeléshez több nyilatkozat is tartozhat.
Összefoglaló. Ellenőrzi az érintett termékeket. Az indoklás nem kötelező.
Megerősítés. A nyilatkozat ekkor rögzül, egyedi azonosítót kap, és elindulnak a visszaigazoló levelek.

Az elutasított vagy megszakított ügy tételei nem foglalják le a mennyiséget egy újabb nyilatkozat számára. A sikeres beküldést és az e-maileket külön is ellenőrizd a teszteléskor.

Ügyintézés és vezérlőpult

A Komponensek → Elállások alatt a nyilatkozatok önálló ügyekként szerepelnek. Az ügy adatlapján láthatók a tételek, a mennyiségek, az események és a visszatérítés adatai. A belső megjegyzést és a vásárlónak szánt üzenetet külön kezeld.

Az állapotok: beküldve, visszaküldésre vár, visszaérkezett, ellenőrzés alatt, jóváhagyva, visszatérítve, elutasítva és megszakítva. A felület csak az adott állapotból megengedett következő lépéseket kínálja. Elutasításkor indoklás kell. A már eldöntött ügy külön művelettel újranyitható.

A rendszer visszatérítési javaslatot ad. Kedvezmény, kupon vagy szállítási költség esetén ellenőrizd az összeget. A tényleges utalást a webshop saját pénzügyi folyamatában végezd el, majd rögzítsd az ügyben.

A csomag adminmodulja az új ügyek számát, a legutóbbi nyilatkozatokat és az ellenőrzés alatt lévő ügyeket mutatja. A Joomla adminisztrátori moduljai között publikálhatod a vezérlőpult megfelelő pozíciójára. Az eseménynapló a felületen nem szerkeszthető.

Frissítés és ellenőrzés

Frissítés előtt mentsd a weboldalt és az adatbázist. A csomag Joomla-frissítési forrást tartalmaz; az új verzió a Joomla bővítményfrissítései között kereshető. Kézzel is telepítheted az új teljes csomagot a meglévő fölé. Frissítéshez ne távolítsd el előbb a bővítményt.

Utána ellenőrizd a pluginokat, a menüpontot, a saját szövegeket, a vendégazonosítást, egy részleges elállást és az e-maileket. A telepített verzióhoz tartozó változásokat a változásnapló sorolja fel.

Ha valami nem működik

Jelenség	Első ellenőrzés
Nem indul a vásárlói folyamat	Ellenőrizd a két plugin engedélyezését, a menüpont publikáltságát és hozzáférését, majd a Súgó és ellenőrzés jelentését.
Nem található a rendelés	A rendeléshez tartozó e-mail-címmel és a pontos rendelési hivatkozással próbáld. Sok sikertelen kísérlet után az időablak lejártáig várni kell.
Nincs HikaShop-gomb	Ellenőrizd az elhelyezés beállítását és az egyedi sablont. A közvetlen elállási menüpont külön belépési út marad.
Nem érkezik e-mail	Ellenőrizd a Joomla levélküldési tesztjét, a címzetteket és a levélszemét mappát. Egyedi e-mail-sablon után küldj új tesztet.
Rendszerhiba jelenik meg	A részletes hibakeresést csak tesztkörnyezetben kapcsold be: a beállítás hibarészleteket is megjeleníthet a vásárlói oldalon. Az `r2r_withdrawal.log` a Joomla konfigurált naplómappájában található. Hibakeresés után kapcsold ki.

Ha segítség kell, a kapcsolatűrlapon írd meg a Joomla, PHP, HikaShop és R2R verzióját, a lépéseket és a pontos hibaüzenetet. Jelszót és valódi ügyféladatot ne küldj.