# API Manager for WooCommerce

> Licenckulcsok, aktiválások és frissítések kezelése WooCommerce-bolttal értékesített szoftverekhez.

Az API Manager licenckulcs- és frissítéskezelő rendszert ad a WooCommerce-hez. Ha WordPress-bővítményt, sablont, szoftvert vagy API-hozzáférést árulsz a boltodban, a bővítmény a vásárláskor automatikusan licenckulcsot állít elő, korlátozza, hány helyen használható, és frissítéseket is kiszolgál a vásárlóid szoftverének.

Tipikus felhasználás:

- WordPress-bővítmények és sablonok licencelése, frissítések kiszolgálása.
- Webszolgáltatás vagy API elérésének védelme licenckulccsal.
- Mobilalkalmazás vagy letölthető szoftver hozzáférésének kezelése.
- Lejáró hozzáférések megújítása, türelmi idővel és emlékeztető e-mailekkel.

## Követelmények

- WordPress és WooCommerce (a WooCommerce aktív bővítmény kell legyen).
- HTTPS-sel működő webhely: az API-hívásokhoz biztonságos kapcsolat kell.
- A vásárlónak fiókkal kell rendelkeznie, mert a licenc a felhasználói azonosítóhoz kötődik.

## Telepítés és első lépések

1. Telepítsd és kapcsold be a **WooCommerce** bővítményt, majd az **API Manager for WooCommerce** bővítményt.
2. A bővítmény új menüpontot hoz létre **API Manager** néven, két almenüvel: **Licencek** és **Konfiguráció**.
3. Nyisd meg az **API Manager → Konfiguráció** oldalt, és nézd át az alapbeállításokat ([Beállítások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/beallitasok/)).
4. Hozz létre vagy szerkessz egy terméket, jelöld be a **Licencelés** jelölőnégyzetet, és töltsd ki a **Licencelés** fül mezőit ([Licencelt termék beállítása](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/termek-beallitas/)).
5. Kösd össze a szoftvered az API Managerrel a PHP-könyvtárral vagy saját kliensekkel ([PHP-könyvtár](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/php-konyvtar/), [API-hívások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/api/)).
6. Teszteld: rendelj a termékből, és nézd meg a licencet a rendelésen ([Rendelések és licencek](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/rendelesek-licencek/)).

Amint egy vásárló kifizeti a licencelt terméket, a bővítmény automatikusan létrehozza a licenckulcsot. A kulcs rákerül a rendelésre, és a vásárló a **Fiókom** oldalán is látja ([Vásárlói fiók](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/vasarloi-fiok/)).

## Tartalom

- [Licencelt termék beállítása](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/termek-beallitas/): a **Licencelés** fül a termékszerkesztőben, egyszerű és variálható termékek.
- [Beállítások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/beallitasok/): az **API Manager → Konfiguráció** oldal négy füle.
- [Rendelések és licencek](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/rendelesek-licencek/): licencek a rendelésen, aktiválások törlése, a **Licencek** lista.
- [Vásárlói fiók](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/vasarloi-fiok/): amit a vásárló lát a **Fiókom** oldalon.
- [Lejárat, megújítás, türelmi idő](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/lejarat-megujitas/): időkorlátos licencek és emlékeztető e-mailek.
- [API-hívások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/api/): a licencszerver végpontjai, kérések és válaszok.
- [PHP-könyvtár](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/php-konyvtar/): WordPress-bővítmények és sablonok bekötése.
- [Hibaelhárítás](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/hibaelharitas/): gyakori hibák, szerverbeállítások, tanácsok.

### Rendelések, licencek és előfizetések

- [Amazon S3 beállítása a letöltésekhez](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/alapfunkciok-amazon-s3/): korlátozott AWS-felhasználó, tároló, tárolószabály és a fájl bekötése.
- [Licencek WooCommerce Subscriptionsszel és Constellationnel](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/alapfunkciok-elofizetesek-constellation/): licenc és aktiválások előfizetés-állapot és tervváltás esetén.

## Licenckulcs-típusok

Amikor a vásárló licencelt terméket vesz, kulcsot kap a hozzáféréshez. Két típus van:

| Típus | Kinek jó | Mihez fér hozzá | Módosítható? |
|---|---|---|---|
| Felhasználói licenckulcs | Akinek egyetlen kulcs kell mindenhez | Az összes licencelt termékhez | Igen, az admin cserélheti |
| Termékenkénti licenckulcs | Aki termékenként külön kulcsot szeretne | Egy termékhez, rendelésenként | Nem; minden termékhez és rendeléshez új kulcs készül |

Alapesetben a felhasználói kulcs ajánlott: nem kell újraaktiválni, ha a vásárló újabb terméket vesz, és egyszerűbb a használata. A választást az **API Manager → Konfiguráció → Licencelés** fül **Engedélyezett típusok** beállítása adja ([Beállítások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/beallitasok/)). Az aktiváláshoz a kulcsot más értékekkel együtt küldi a kliens a kérésben ([API-hívások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/api/)).

## Letöltések és frissítési fájlok

A frissítésekhez használt fájl lehet a helyi szerveren, Amazon S3-on vagy távoli URL-en. A letöltési hivatkozás biztonságos, a beállított idő után lejáró URL-be van csomagolva. A licencelt termék és a letöltések beállítását a [Licencelt termék beállítása](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/termek-beallitas/), az S3 adatait a [Beállítások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/beallitasok/) fejezet írja le.

## Frissítés előtt

A bővítmény a saját szoftvered ellenőrző szervere, ezért egy elrontott frissítés az aktiválásokat és a vevők frissítéseit is blokkolhatja.

- Frissítés előtt mindig készíts biztonsági mentést, kisebb és nagyobb verziónál egyaránt.
- Éles frissítés előtt próbáld ki a próbakörnyezetben.
- Ellenőrizd, hogy a termékeidben használt PHP-könyvtár kompatibilis az új verzióval.
- Saját API-kliens esetén teszteld a fontos kéréseket.