# Űrlap beszúrása blokkal, klasszikus szerkesztővel és shortcode-dal

> Az űrlap oldalra vagy bejegyzésbe tétele a Gravity Forms blokkal, a klasszikus szerkesztőben és kézzel írt shortcode-dal, a shortcode paramétereivel.

Az űrlapot többféleképpen is beteheted egy oldalba vagy bejegyzésbe. A szerkesztőből induló **Beágyazás** panelről a [Űrlap beágyazása](https://hub.hellowp.io/hu/plugins/gravityforms/elso-lepesek-urlap-beagyazasa/) fejezet szól. Itt a blokk, a klasszikus szerkesztő és a kézi shortcode van leírva. Mindhez előbb létre kell hoznod az űrlapot, lásd [Új űrlap létrehozása](https://hub.hellowp.io/hu/plugins/gravityforms/elso-lepesek-uj-urlap-es-szerkeszto/).

## Gravity Forms blokk

A blokkszerkesztőben a Gravity Forms beépített blokkja teszi be az űrlapot.

1. Nyisd meg az oldalt vagy bejegyzést, amelyikbe az űrlapot szeretnéd tenni.
2. Kattints a plusz jelre új blokk hozzáadásához.
3. A blokkkereső mezőbe írd be: „gravity” vagy „form”.
4. A **Beágyazások** csoportban kattints az **Űrlap** blokkra. Ez beszúrja a Gravity Forms blokkot.
5. Az űrlap kiválasztó legördülő listájában válaszd ki az űrlapodat. Az űrlap beszúródik.

A blokk beállításait (például megjelenés, cím és leírás, AJAX) a blokk oldalsávjában módosíthatod.

## Klasszikus szerkesztő

A klasszikus szerkesztőben az **Űrlap hozzáadása** gombbal szúrsz be űrlapot.

1. A szerkesztő feltöltés/beszúrás eszköztárán, a Vizuális/Szöveg fülektől balra kattints az **Űrlap hozzáadása** gombra. Megnyílik az **Űrlap beszúrása** ablak.
2. Válaszd ki az űrlapot az **Űrlap kiválasztása** legördülő listából. Ha nem találod az űrlapot, menj vissza az űrlapok listájához, és ellenőrizd, hogy az űrlap aktív-e.
3. Állítsd be a kívánt lehetőségeket:

   | Lehetőség | Mit csinál |
   |---|---|
   | Űrlap címének megjelenítése | Kiírja az űrlap címét. |
   | Űrlap leírásának megjelenítése | Kiírja az űrlap leírását. |
   | AJAX engedélyezése | Az űrlap oldalfrissítés nélkül küldhető be. A reCAPTCHA korlátai miatt a reCAPTCHA-mezőt tartalmazó űrlapok akkor sem AJAX-szal mennek be, ha ezt bekapcsolod. |
   | Tabindex (a speciális beállításoknál) | Az űrlap mezőinek kezdő tabindex-értéke. |

4. Kattints az **Űrlap beszúrása** gombra: a Gravity Forms shortcode-ja bekerül a tartalomba.
5. Mentsd az oldalt vagy bejegyzést.

A shortcode-ot kézzel is beírhatod a tartalomba, vagy az űrlapszerkesztő **Beágyazás** gombjával kimásolhatod az űrlapról.

## Az űrlap shortcode-ja

A shortcode a WordPress helyőrzője: az oldal betöltésekor egy függvényt indít el. A Gravity Forms űrlap shortcode-ja a fő módja az űrlap megjelenítésének, és mindenhol használható, ahol a shortcode támogatott (leggyakrabban oldal- vagy bejegyzéstartalomban). A blokkszerkesztő magától előállítja, de a paraméterek ismeretében kézzel is finomíthatod.

Példa:

```text
[gravityform id="1" title="false" description="false" ajax="true" tabindex="49" field_values="check=First Choice,Second Choice" theme="orbital"]
```

### Paraméterek

Az `id` kivételével mind elhagyható.

| Paraméter | Mit csinál | Példa |
|---|---|---|
| `id` | Kötelező. A beágyazandó űrlap azonosítója (az űrlaplistában látod). | `id="1"` |
| `title` | Megjelenjen-e az űrlap címe. Alapértéke `true`. | `title="false"` |
| `description` | Megjelenjen-e az űrlap leírása. Alapértéke `true`. | `description="true"` |
| `ajax` | AJAX-szal küldje-e be az űrlapot. | `ajax="true"` |
| `tabindex` | A mezők kezdő tabindex-értéke. Az alapérték `0`: ilyenkor a Gravity Forms nem ír tabindex-attribútumot, és a böngésző maga határozza meg a tabulátorsorrendet. | `tabindex="4"` |
| `field_values` | A mezők alapértelmezett értéke (dinamikus kitöltés). | `field_values="check=First Choice,Second Choice"` |
| `theme` | Az űrlapra alkalmazott sablon azonosítója: `orbital` az Orbital sablonhoz, `gravity` a Gravity Forms 2.5-ös sablonhoz. Az így megadott Orbital űrlap az Orbital alapértelmezett stílusbeállításait kapja. | `theme="orbital"` |
| `styles` | Opcionális, JSON formátumú stílusbeállítások. | lásd lent |

A `styles` paraméter JSON-t vár, például:

```text
styles='{"theme":"","inputSize":"md","inputBorderRadius":"20","inputBorderColor":"#0693e3","inputBackgroundColor":"#fff","inputColor":"#112337","inputPrimaryColor":"#204ce5","labelFontSize":"20","labelColor":"#112337","descriptionColor":"#585e6a","buttonPrimaryBackgroundColor":"#7700e6","buttonPrimaryColor":"#fff"}'
```

### Shortcode beszúrása a Shortcode blokkal

Ha a blokkszerkesztőben shortcode-dal akarod beszúrni az űrlapot (a Gravity Forms blokk helyett):

1. Jegyezd meg az űrlap azonosítóját.
2. A blokkszerkesztőben kattints a plusz jelre az új blokk helyén.
3. A keresővel keresd meg a **Shortcode** blokkot (a **Widgetek** csoportban), és add hozzá.
4. Írj a blokkba érvényes Gravity Forms shortcode-ot, az `id=` után a megjegyzett azonosítóval.
5. Nézd meg az előnézetet, hogy minden rendben van-e.

### Gyakori hibák

- **„Hoppá! Nem találtuk meg az űrlapodat.”** felirat: a shortcode-ban megadott azonosítóval nincs űrlap. Ellenőrizd az azonosítót az űrlaplistában.
- **Az AJAX-küldés nem működik:** ellenőrizd, hogy a böngészőben engedélyezve van-e a JavaScript, és hogy nincs-e a beküldést akadályozó JavaScript-hiba (a böngésző fejlesztői konzoljában látszik).
- **A mezők nem töltődnek ki előre:** nézd meg, hogy a `field_values` helyes mezőneveket és szintaxist használ-e. A mezőnevek megkülönböztetik a kis- és nagybetűt.
- **A stílus nem érvényesül:** ellenőrizd, hogy a `styles` paraméter JSON-ja érvényes-e. Az érvénytelen JSON figyelmen kívül marad.

### Bővítés

Más bővítmények is kibővíthetik a shortcode működését. Ilyen például a hivatalos Felhasználóregisztráció kiegészítő, amely saját shortcode-műveleteket ad.