# PHP-könyvtár

> WordPress-bővítmény vagy sablon bekötése az API Managerbe a PHP-könyvtárral: aktiválás és frissítések.

A WooCommerce API Manager PHP-könyvtára egy kis, a kódodba beépíthető csomag, amely licenckulcs-hitelesítést és frissítéskiszolgálást ad a WordPress-bővítményedhez vagy sablonodhoz. A könyvtár nyílt forráskódú, a GitHubról tölthető le, ahol hibát is jelezhetsz.

## Bekötés

A könyvtár beépítése után egyetlen kódrészlettel kapcsolod a bővítményed az API Managerhez. A kódrészletben a második paraméter a `product_id`:

- Ha üresen hagyod, a vevőnek kell megadnia az azonosítót.
- Ha fixen beírod, a vevőnek elég a licenckulcsot megadnia az aktiváláskor. Ez az ajánlott.

Variálható terméknél a szülőtermék vagy egy konkrét variáció azonosítóját írd be. A szülő azonosítójával a vevő szintet válthat (például előfizetésváltásnál) új fájl letöltése nélkül. Konkrét variációnál a vevőnek új fájlt kell letöltenie, vagy az aktiváláskor meg kell adnia az azonosítót.

## A vevő oldalán

1. A bővítmény telepítése után a vevő értesítést lát, amely a licenckulcs aktiválására kéri. Ez kikényszeríti a licencet, és bekapcsolja a frissítéseket.
2. Az aktiváló képernyőn, ha a `product_id` fixen be van írva, elég a licenckulcsot megadni. Ha nincs, a kulcs és a termékazonosító is kell. Ez nehezebbé teszi az aktiválást, ezért nem ajánlott, de bonyolultabb licencelési helyzetekben szükség lehet rá.
3. Aktiválás után egy értesítés mutatja a hátralévő aktiválások számát, így a vevő látja, hány eszköz használja a licencet és hány hely van még.
4. Ha frissítés érhető el, a szokásos WordPress frissítési értesítés jelenik meg. A vevő a **Részletek megtekintése** gombbal megnézheti a változásnaplót és a verzióadatokat, majd egy kattintással telepítheti a frissítést, mint bármelyik wordpress.org-os bővítményét. A megjelenő adatok közvetlenül a hozzá tartozó WooCommerce-termékből jönnek.
5. Deaktiválás után az irányítópult frissíti a hátralévő aktiválások számát.

## Az eladó oldalán

- A rendelések listájában a licenckulccsal rendelkező aktiválásoknál a licenckulcs is látszik, így könnyű azonosítani a kiadott kulcsot, a vevőt és az aktiválási előzményeket.
- Az egyes rendeléseken az összes aktiválás látszik: mikor és hol aktiválták, hány aktiválás használt, és érvényes-e még a kulcs ([Rendelések és licencek](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/rendelesek-licencek/)).
- Ha a vevőnek segítened kell, a rendelésen törölheted az aktiválásokat, így felszabadítva a helyeket.

## Verziófrissítés

A termékeidben használt könyvtárat érdemes naprakészen tartani. Az API Manager figyelmeztetést jelenít meg az admin felületen, ha a használt könyvtár újabb verziója elérhető, és ajánlja a frissítést. A 2.0 előtti kulcsokhoz régi könyvtárverzió nem biztos, hogy minden esetben frissítést tud kapni, ilyenkor frissítsd a könyvtárat ([Hibaelhárítás](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/hibaelharitas/)).

Saját integrációt a közvetlen API-hívásokkal is építhetsz ([API-hívások](https://hub.hellowp.io/hu/plugins/woocommerce-api-manager/api/)).