# Használat

> Az API-kulcs megadása és a MailerLite művelet beállítása a JetFormBuilder űrlapokon.

A kiegészítő felülete angol nyelvű, ezért a fejezetben a feliratok szó szerint, angolul szerepelnek.

## Az API-kulcs megszerzése

1. Lépj be a MailerLite-fiókodba. Ha még nincs fiókod, regisztrálj, és a regisztráció minden lépését végezd el.
2. Kattints a profilképed melletti legördülő nyílra a felső eszköztár jobb szélén.
3. Válaszd az **Integrations** menüpontot.
4. A **MailerLite API** résznél, a **Developer API** sorban kattints a **Use** gombra.
5. Az új oldalon látszik az API-kulcs. Másold ki.

## Az API-kulcs megadása

A kulcsot két helyen adhatod meg: egyszer globálisan, hogy minden űrlap ezt használja, vagy közvetlenül egy-egy űrlap műveletében.

### Globális beállítás

1. Nyisd meg a **JetFormBuilder → Settings** oldalt.
2. Válaszd a **MailerLite API** fület.
3. Írd be a kulcsot az **API key** mezőbe.
4. Kattints a **Save** gombra.

![A JetFormBuilder Settings oldal MailerLite API füle az API key mezővel](./kepek/beallitasok-api-kulcs.webp)

*A JetFormBuilder Settings oldal MailerLite API füle az API key mezővel* (https://minta-bolt.hu/wp-admin/edit.php?post_type=jet-form-builder&page=jfb-settings)

A mező alatti **here** hivatkozás a kulcs megszerzését magyarázza.

## A MailerLite művelet felvétele az űrlapra

1. Nyisd meg a **JetFormBuilder → Forms** listából a kívánt űrlapot, vagy kattints az **Add New Form** gombra.
2. A jobb oldali **JetForm** panelen nyisd ki a **Post Submit Actions** részt, és kattints a **New Action** gombra.
3. A listából válaszd a **MailerLite** műveletet.

![Az Add new action ablak a MailerLite művelettel](./kepek/muvelet-valaszto.webp)

*Az Add new action ablak a MailerLite művelettel* (https://minta-bolt.hu/wp-admin/post.php?post=4&action=edit)

A listában a **MailerLite** mellett **MailerLite Classic** is szerepel; ennek leírását lásd lejjebb.

A kiválasztás után megnyílik az **Edit MailerLite** ablak. Később a művelet sorában a ceruza ikonnal nyithatod meg újra.

![Az Edit MailerLite ablak a Use Global Settings kapcsolóval és az API KEY mezővel](./kepek/muvelet-szerkesztes.webp)

*Az Edit MailerLite ablak a Use Global Settings kapcsolóval és az API KEY mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=4&action=edit)

## A művelet beállításai

| Beállítás | Mit csinál | Alapérték |
| --- | --- | --- |
| **Use Global Settings** | Bekapcsolva a művelet a **JetFormBuilder → Settings → MailerLite API** alatt mentett kulcsot használja. | Ki |
| **API KEY** | A MailerLite API-kulcsa (kötelező). | Üres |
| **Fetch** | Elküldi a kulcsot a MailerLite-nak, ellenőrzi, és letölti a fiókodhoz tartozó csoportokat és mezőket. Ha a kérés nem sikerül, a **Retry request** gomb újra ellenőrzi a kulcsot. | |
| **Group** | Legördülő lista a MailerLite-fiókodban lévő feliratkozói csoportokkal. Az új feliratkozó a kiválasztott csoportba kerül, és a csoporthoz tartozó címke is rákerül. | |
| **Fields Map** | Összerendelés az űrlap mezői és a MailerLite feliratkozó mezői között. | |
| **Update Tags List** | A MailerLite-fiók csoportjainak újraszinkronizálása az űrlappal. | |

### Lépésről lépésre

1. Add meg az API-kulcsot (vagy kapcsold be a **Use Global Settings** kapcsolót).
2. Kattints a **Fetch** gombra. Ha a kulcs érvényes, megjelenik a **Group** lista és a **Fields Map**.
3. A **Group** listában válaszd ki a csoportot, amelybe a feliratkozók kerülnek.
4. A **Fields Map** részben rendeld az űrlap mezőit a MailerLite mezőihez: minden elem mellett a legördülő listából válaszd ki, melyik űrlapmező adja az értéket. Az **Email** mező kötelező, a többi üresen hagyható.
5. Kattints az **Update** gombra.

Mostantól minden sikeres beküldésnél az új feliratkozó megjelenik a MailerLite-fiókod **Subscribers** listájában.

> Az **Update Tags List** gombbal frissítheted a csoportlistát, ha a MailerLite-ban utólag új csoportot hoztál létre.

## MailerLite Classic

A MailerLite 2022 márciusában új verziót adott ki, a régit azóta MailerLite Classicnak hívják. A két változat API-ja eltér, ezért két külön művelet van:

- **MailerLite**: az új MailerLite-fiókokhoz. A fenti leírás erre vonatkozik.
- **MailerLite Classic**: a régi verziót használóknak. Az **Edit MailerLite Classic** ablak tetején figyelmeztetés látszik a váltásról, alatta a **Use Global Settings** kapcsoló, az **API KEY** mező és a **Validate API Key** gomb.

![Az Edit MailerLite Classic ablak a figyelmeztetéssel és az API KEY mezővel](./kepek/muvelet-klasszikus.webp)

*Az Edit MailerLite Classic ablak a figyelmeztetéssel és az API KEY mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=4&action=edit)

Ha nem a régi verziót használod, a **MailerLite** műveletet válaszd, mert a két rendszer API-ja különbözik.

## Tippek

- A MailerLite-művelet együtt használható a Stripe Payments kiegészítővel: ugyanaz az űrlap kezeli a fizetést és a levelezőlistára való felvételt.
- A művelet sorában feltételt is beállíthatsz, hogy csak bizonyos esetben fusson.