# Funkciók és beüzemelési ellenőrzőlista

> Melyik követelményt melyik funkció oldja meg, milyen integrációk vannak, és mit érdemes végigmenni új telepítésnél.

A bővítmény nem csak egy gomb: jogilag védhető, naplózott, rendeléshez kötött folyamatot és adminisztrálható ügykezelést ad. Ingyenes, GPL-2.0 vagy újabb licencű, és kompatibilis a WooCommerce egyedi rendelési tábláival (HPOS).

## Követelmény és megoldás

### Az elállás

| Követelmény | Megoldás |
|---|---|
| Könnyen megtalálható | Önálló `/elallas/` oldal, `[elallas_form]` shortcode, Gutenberg blokk, Elementor widget, **Fiókom → Elállás** végpont, rendelés-oldali gomb és a rendelési e-mailbe ágyazott link. A fiókból vagy a rendelés oldaláról két kattintáson belül elérhető. |
| Elektronikus nyilatkozat | Kétlépcsős űrlap: azonosítás (rendelésszám és e-mail), tételek kiválasztása, megerősítés. Regisztráció nélkül, vendégként is működik. |
| Külön megerősítő lépés | **Elállás megerősítése** gomb és három kifejezett nyilatkozat-pipa (adatok, szándék, hozzájárulás). Opcionális visszatérítési bankszámla (IBAN, titkosítva tárolva) és szabad szöveges megjegyzés. |
| Helyes megfogalmazás | Alapértelmezett felirat: **Elállás a szerződéstől**. A szövegek szerkeszthetők. |
| Tartós adathordozós visszaigazolás | Automatikus e-mail az elállás adataival és a beérkezés időpontjával. Opcionálisan PDF elállási nyilatkozat (SHA-256 hash-sel) is csatolható, és a vásárlói e-mailhez szerkeszthető extra szöveg fűzhető. |
| A fogyasztó nyelve | WPML, Polylang és TranslatePress integráció, a jogi szövegek nyelvenként kezelhetők. |
| Teljes vagy részleges elállás | Rendelésenként, tételenként és mennyiségenként is. |
| Visszatérítési határidő | A 14 napos határidőt kiszámolja és jelöli (határidőn belül, lejárt, nem megállapítható), de sosem blokkol. A végső döntés a tiéd. |
| Igazolhatóság | Rendelés-pillanatkép (a beküldéskori nevek, SKU-k, mennyiségek, összegek megmaradnak), csak hozzáfűzhető eseménynapló (ki, mikor, mit), egyedi ügyszám (például `EL-2026-000001`) és token-védett PDF-letöltés. |
| B2B megkülönböztetés | A valószínűleg céges rendeléseket cégnév vagy adószám alapján jelöli, nem blokkol. |
| Adatvédelem | Az e-mail hash-elve és opcionálisan titkosítva tárolódik. Az IP és a böngészőazonosító teljes, hash-elt vagy kikapcsolt módban kezelhető. Állítható megőrzési idő napi automatikus anonimizálással. |
| Biztonság | Nonce, korlátozás és rejtett mező (honeypot) a rendelésszám-próbálgatás ellen, semleges azonosítási hibaüzenet (nem árulja el, melyik adat rossz), jogosultság-ellenőrzés, védett dokumentumkönyvtár. |

A beállítások részletei: [Beállítások](https://hub.hellowp.io/hu/plugins/elallas-for-woo/hasznalat-beallitasok/). A vásárló útja: [A vásárlói folyamat](https://hub.hellowp.io/hu/plugins/elallas-for-woo/hasznalat-vasarloi-folyamat/).

### Ügykezelés

A beérkezett elállások a **WooCommerce → Elállási ügyek** alatt naplózott ügyként jelennek meg: szűrhető lista, részletes ügynézet (összefoglaló, nyilatkozat, rendelés-pillanatkép, napló, admin döntés, dokumentumok), CSV export és átlátható státuszfolyamat a beérkezéstől a visszatérítésen át a lezárásig. A visszatérítést az ügy oldaláról egy kattintással rögzítheted a WooCommerce-ben, pénzmozgás nélkül. Részletek: [Ügykezelés](https://hub.hellowp.io/hu/plugins/elallas-for-woo/hasznalat-ugykezeles/).

Parancssorból a `wp elallas` parancsokkal kezelhető ([WP-CLI, eltávolítás és biztonság](https://hub.hellowp.io/hu/plugins/elallas-for-woo/hasznalat-wp-cli/)). A bővítmény REST API-t is ad (`elallas-for-woo/v1`: azonosítás, ügyek, megerősítés, státusz, dokumentum), és az LW Site Manager képességein keresztül (ügyek listázása és lekérése, státuszváltás, napló olvasása a WordPress Abilities API-n át) AI- vagy REST-ügynökök is dolgozhatnak vele.

### Integrációk

- **Számlázás:** Számlázz.hu, Billingo és NAV ÁFA-felismerés rendelés-jegyzetekkel, automatikus sztornó nélkül.
- **Szállítás:** a futár kézbesítési dátuma (GLS, Packeta és Foxpost, MPL, DPD, Shipment Tracking) a határidő kezdetéhez használható.
- **Oldalszerkesztők:** Gutenberg blokk és Elementor widget az elállási űrlaphoz, az `[elallas_form]` shortcode univerzális tartalékként.
- **Beüzemelő varázsló:** webshop-adatok, a `/elallas/` oldal automatikus létrehozása, megjelenítési kapcsolók, határidő és egy teszt lépés.

### Szavatossági tájékoztató és GARAN

| Követelmény | Megoldás |
|---|---|
| Hivatalos tájékoztató változatlanul | A Bizottság hivatalos, bájtra azonos fájljai (24 hivatalos nyelv, magyar tartalék) az oldal nyelvén, mellette a QR-kóddal azonos Your Europe link. A képet és a linket sablon-felülírással sem lehet lecserélni. |
| Jól látható elhelyezés | Termékoldal (a kosárba gomb alatt), fejléc, lábléc, a rendelés gomb előtt (klasszikus és blokkos pénztár, „Rendelés kifizetése” oldal), rendelésnézet (köszönőoldal, Fiókom) és a vásárlói rendelési e-mailek. Rövid feliratról nyílik, vagy beágyazva látszik. Egy kattintással önálló `/szavatossag/` oldal is létrehozható. |
| GARAN címke | Termékenként kapcsolható be (időtartam, gyártó, modellazonosító). A bővítmény ellenőrzi, hogy az értékek elférnek-e a címke fix mezőiben, és előnézetet mutat. A variációk öröklik a szülő adatait, de saját adatot is kaphatnak. |
| Figyelemfelhívás a rendelés előtt | Amíg a GARAN modul be van kapcsolva, az érintett tételek címkéi mindig megjelennek a rendelés vagy fizetés gomb előtt. Beállítással ez nem kapcsolható ki. |
| Igazolhatóság | A címke adatai a rendeléskor a rendelési tételre mentődnek, így a termék későbbi módosítása nem írja át a korábbi rendeléseket. |
| Hatókör | Csak árukra vonatkozik: a tisztán virtuális termékek kizárhatók, céges rendeléseknél a megjelenés elrejthető. |
| Megfelelőség-ellenőrzés | Admin figyelmeztetés, ha a tájékoztató vagy a GARAN ki van kapcsolva, nincs elhelyezve, vagy a beállítások még nincsenek átnézve. A módosított hivatalos GARAN fájlt a bővítmény felismeri (SHA-256), és nem jeleníti meg a címkét. |

A szavatossági beállítások a **Szavatosság és GARAN** fülön vannak: [Szavatossági tájékoztató és GARAN címke](https://hub.hellowp.io/hu/plugins/elallas-for-woo/hasznalat-szavatossag-garan/).

## Beüzemelési ellenőrzőlista

Friss telepítésnél, aktiválás után egyszer érdemes végigmenni rajta.

**Előfeltételek**

- A WooCommerce 8.0 vagy újabb telepítve és aktív.
- PHP 8.0 vagy újabb (a 8.2 vagy újabb ajánlott).
- Az `AUTH_KEY` és az `AUTH_SALT` be van állítva a `wp-config.php`-ban, mert ezekből származnak az adatok titkosítási kulcsai.

**Létrehozás és engedélyezés**

1. Futtasd a beüzemelő varázslót a **WooCommerce → Elállás - beállítások** oldalon.
2. Hozd létre a nyilvános elállási oldalt (`/elallas/`). A varázsló beilleszti az `[elallas_form]` shortcode-ot, és megjelenítési oldalként beállítja. Kézzel is létrehozhatsz egy oldalt, és kiválaszthatod az **Általános** fülön.
3. Kapcsold be az engedélyező főkapcsolót az **Általános** fülön.

**Beállítás fülenként**

| Fül | Teendő |
|---|---|
| **Általános** | Erősítsd meg a gomb feliratát (**Elállás a szerződéstől**), és válaszd ki a megjelenítési felületeket (Fiókom, rendelés részletei, rendelési e-mail). A linket máshová is kiteheted az `[elallas_form]` vagy az `[elallas_button]` shortcode-dal, a Gutenberg blokkal, az Elementor widgettel vagy menüponttal. |
| **Határidő** | Állítsd be az elállási ablakot (alapból 14 nap), a kezdő dátumot (rendelés, teljesítés vagy kézbesítés) és a lejárt kérések kezelését. |
| **Rendelési státuszok** | Válaszd ki, mely rendelési státuszoknál indítható elállás. Opcionálisan engedélyezheted az egyedi `wc-withdrawal-*` rendelési státuszokat. |
| **Adatvédelem** | IP és böngészőazonosító tárolása (teljes, hash-elt, kikapcsolt), e-mail-titkosítás és megőrzési idő. A napi ütemezett feladat anonimizálja a régebbi ügyeket. |
| **E-mailek** | Engedélyezd a vásárlói, admin és státusz e-maileket, és add meg az admin címzettet. |
| **Jogi szövegek** | Nézd át a nyilatkozat és a visszaigazoló szövegeket, és validáltasd jogásszal. |
| **Kivételek** | A nem visszaküldhető termékeknél jelöld be az **Elállásból kizárt** opciót a termék **Általános** fülén. Egész csoport kizárásához szerkessz egy termékkategóriát vagy címkét, és ott jelöld be. A termékszintű beállítás az erősebb. A kizárás jelöl, automatikusan sosem blokkol. |

**Szavatosság és GARAN**

1. Nézd át a **Szavatosság és GARAN** fület (a tájékoztató és a GARAN alapból be van kapcsolva), és mentsd el.
2. A 2 évnél hosszabb gyártói tartóssági jótállású termékeknél töltsd ki a termékszerkesztőben a **Gyártói tartóssági jótállás (GARAN címke)** mezőit (időtartam, gyártó, modellazonosító). Eltérő variációknál a variáció GARAN címke beállításában add meg.
3. Ellenőrizd a termékoldalon a tájékoztatót és a címkét, a pénztárban pedig azt, hogy mindkettő a rendelés gomb előtt jelenik meg.

**Teszt élesítés előtt**

1. Adj le egy tesztrendelést, és állítsd jogosult státuszba (például Teljesítve).
2. Küldj be egy elállást a `/elallas/` oldalon: rendelésszám és e-mail, tételek kiválasztása, három pipa, megerősítés.
3. Ellenőrizd, hogy az ügy megjelenik a **WooCommerce → Elállási ügyek** alatt, a visszaigazoló e-mail kimegy, és a PDF elkészül.
4. Próbálj hibás e-mail-címmel azonosítani: a semleges „nem található vagy nem jogosult” jellegű üzenetet kell kapnod, anélkül, hogy kiderülne, melyik adat hibás.

**Éles üzemeltetés**

- Nginx vagy LiteSpeed alatt az `uploads/elallas-docs/` mappa `.htaccess` fájlját a szerver figyelmen kívül hagyja. A PDF-ek kitalálhatatlan fájlnevet és token-védett letöltést használnak, de érdemes a szerveren is tiltó `location` szabályt felvenni erre a mappára.

## Ismert korlátok

- A GARAN címke az e-mailben csak GD FreeType-támogatású tárhelyen jelenik meg képként, enélkül szövegként (évek, gyártó, modell) és linkként.
- A terméklistákon (archívum) a GARAN címke csak klasszikus témával jelenik meg. Blokktémánál a termékoldalon, a kosárban és a pénztárban látszik.
- A szoftverfrissítési és javíthatósági információt egyelőre a termékleírásban tüntesd fel.
- A szavatossági Gutenberg-blokk és Elementor-widget később érkezik, addig a Shortcode blokkal vagy widgettel helyezd el a shortcode-okat.
- A blokkos kosár expressz fizetési gombjai előtt a GARAN címke nem jelenik meg (a klasszikus kosárban igen).
