# Használat

> Az API-kulcs megadása, a Moosend művelet beállítása és az egyéni mezők használata 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 Moosend-fiókodba. Ha még nincs fiókod, regisztrálj.
2. Kattints a fogaskerék ikonra a felső eszköztár jobb szélén.
3. Nyisd meg az **Account Settings → Api Key** oldalt.
4. Másold ki a kulcsot a megfelelő gombbal.

## 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 **Moosend API** fület.
3. Írd be a kulcsot az **API key** mezőbe.
4. Kattints a **Save** gombra.

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

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

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

## A Moosend 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 **Moosend** műveletet.

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

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

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

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

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

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

| Beállítás | Mit csinál | Alapérték |
| --- | --- | --- |
| **Use global** | Bekapcsolva a művelet a **JetFormBuilder → Settings → Moosend API** alatt mentett kulcsot használja, és kitölti vele az **API KEY** mezőt. | Ki |
| **API KEY** | A Moosend API-kulcsa (kötelező). | Üres |
| **Fetch** | Elküldi a kulcsot a Moosendnek, ellenőrzi, és letölti a fiókodhoz tartozó levelezőlistákat és mezőket. A kulcs ellenőrzése után a gomb felirata **Retry request** lesz: ezzel újra ellenőrizheted a kulcsot, vagy szinkronizálhatsz a Moosenddel. | |
| **Double Opt-in** | Kapcsoló: be- vagy kikapcsolja a feliratkozás e-mailes megerősítését. Hasznos, ha ki akarod szűrni az érvénytelen e-mail-címekkel történő regisztrációkat. | |
| **Mailing lists** | Legördülő lista a Moosend-fiókodban létrehozott levelezőlistákkal. Az új feliratkozó a kiválasztott listára kerül. | |
| **Fields Map** | Összerendelés az űrlap mezői és a Moosend feliratkozó mezői között. | |

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

1. Add meg az API-kulcsot, vagy kapcsold be a **Use global** kapcsolót.
2. Kattints a **Fetch** gombra. Ha a kulcs érvényes, megjelennek a további beállítások.
3. Szükség esetén kapcsold be a **Double Opt-in** kapcsolót.
4. A **Mailing lists** listában válaszd ki a levelezőlistát, amelyre a feliratkozók kerülnek.
5. A **Fields Map** részben rendeld az űrlap mezőit a Moosend mezőihez: az **Email** és a **First Name** mellett a legördülő listából válaszd ki, melyik űrlapmező adja az értéket. Csak az **Email** kötelező, a **First Name** üresen hagyható.
6. Kattints az **Update** gombra.

Mostantól minden sikeres beküldésnél az új feliratkozó megjelenik a Moosend-fiókod tagjai (Members) között.

## Egyéni mezők a Moosendben

A kiegészítő az egyéni mezőket is kezeli, akár kötelezőként is.

### Egyéni mező létrehozása

1. A Moosend-fiókodban kattints a **Mailing lists** menüpontra, és válaszd ki a kívánt listát.
2. A bal oldali menüben nyisd meg a **Custom Fields** fület.
3. A jobb felső sarokban kattints az **Add new custom field** gombra.
4. Add meg a **Field Name** értékét, és a legördülő listából válaszd ki az adattípust (**Data Type**): **Text**, **DateTime**, **Number**, **Single Select Dropdown** vagy **Checkbox**.
5. Ha szükséges, adj meg alapértelmezett értéket (**Default Fallback Value**), és pipáld be a **Required** jelölőnégyzetet.
6. Kattints a **Save custom field** gombra.

Ha egy mezőt kötelezőnek jelölsz a Moosendben, a feliratkozó addig nem küldhető be, amíg a mező nincs kitöltve. Ezért a JetFormBuilder űrlapon is jelöld kötelezőnek ugyanazt a mezőt.

### Az egyéni mező bekötése az űrlapba

1. Bővítsd az űrlapot a Moosendben létrehozott új mezőnek megfelelő mezővel.
2. Nyisd meg újra a Moosend műveletet (ceruza ikon), és kattints a **Retry request** gombra. A Moosendben felvett egyéni mezők megjelennek a **Fields Map** részben.
3. Minden új mező mellett válaszd ki a hozzá tartozó űrlapmezőt.
4. Kattints az **Update** gombra.

## Tippek

- Az egyéni mezőket kézzel kell kötelezővé tenni az űrlapon, ha az API-nak ellenőriznie kell őket.
- A kiegészítő nem engedi, hogy egy már meglévő e-mail-címmel újabb feliratkozó jöjjön létre.
- A művelet sorában feltételt is beállíthatsz, hogy csak bizonyos esetben fusson.