# Használat

> Az API-kulcs megadása és a ConvertKit 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 ConvertKit fiókodba (ha még nincs fiókod, regisztrálj).
2. Kattints a profil gombra a felső eszköztár jobb szélén.
3. Válaszd az **Account Settings → General** menüpontot.
4. Az **Account Info** fülön keresd meg az **API Key** mezőt, és másold ki a kulcsot.

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

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

*A JetFormBuilder Settings oldal ConvertKit 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 **More info here** hivatkozás a kulcs megszerzését magyarázza.

## A ConvertKit 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 panelen nyisd ki a **Post Submit Actions** részt, és kattints a **New Action** gombra.
3. A listából válaszd a **ConvertKit** műveletet.

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

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

Az ablak tetején kereshetsz név szerint, és kategóriára is szűrhetsz.

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

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

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

A **Use global** kapcsoló mellett az **API KEY** mező és a **Fetch** gomb látszik.

## 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 → ConvertKit API** alatt mentett kulcsot használja. | Ki |
| **API KEY** | A ConvertKit API-kulcsa (kötelező). | Üres |
| **Fetch** | Elküldi a kulcsot a ConvertKitnek, ellenőrzi, és letölti a fiókodhoz tartozó címkéket és mezőket. | |
| **Tag** | Legördülő lista a ConvertKit-fiókodban létrehozott címkékkel. A kiválasztott címke az új feliratkozóra kerül. | |
| **Fields map** | Összerendelés az űrlap mezői és a ConvertKit 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, a **Tag** lista és a **Fields map** megjelenik. Ha a kérés nem sikerül, a „Fetching data was failed” üzenetet kapod.
3. A **Tag** listában válaszd ki a feliratkozóhoz rendelendő címkét. A listában azok a címkék szerepelnek, amelyeket a ConvertKit-fiókodban már létrehoztál.
4. A **Fields map** részben rendeld az űrlap mezőit a ConvertKit mezőihez. Az e-mail-cím megadása kötelező, a keresztnév (First Name) üresen hagyható. Az egyes ConvertKit mezők mellett legördülő listából válaszd ki, melyik űrlapmező adja az értéket.
5. Kattints az **Update** gombra.

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

> Ha a **Tag** vagy a **Fields map** üres, először mindig a **Fetch** gombbal tölts le adatot az API-ból: addig a beállítások nem érhetők el, és a művelet a „You have to fetch the data from API” üzenetet adja.

## Tippek

- A címkéket a ConvertKit-fiókodban hozod létre. Ha utólag készítettél újat, kattints újra a **Fetch** gombra, hogy a lista frissüljön.
- Fizetős űrlapnál a ConvertKit 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 az **Edit Conditions & Events** ikonnal feltételt állíthatsz be, hogy a művelet csak bizonyos esetben fusson.