# Foglalási űrlapok

> A foglalási űrlapok kihelyezése a weboldalra: shortcode-ok és paramétereik, előválasztás URL-paraméterekkel, lépésenkénti űrlap, eseménylista.

A foglalási űrlapokat a weboldal bármelyik oldalára kiteheted shortcode-dal, vagy Gutenberg-, Elementor- és Divi-modullal. A shortcode-ok paraméterekkel szűrhetők, hogy a látogató csak bizonyos kategóriákat, szolgáltatásokat, munkavállalókat, helyszíneket vagy eseményeket lásson. Ha a szerkesztőd nem ismeri az Amelia moduljait, a shortcode-ot kézzel is beírhatod egy oldalra vagy bejegyzésbe, és az Amelia automatikusan betölti a kiválasztott űrlapot.

Az űrlapok külön fejezetei:

- [Az űrlapok testreszabása](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-testreszabas/) (lépésenkénti űrlap)
- [A katalógus testreszabása](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-testreszabas-katalogus/)
- [Az eseményűrlapok testreszabása](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-testreszabas-esemenyek/)
- [A vásárlói és a munkatársi felület testreszabása](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-testreszabas-panelek/)
- [Az eseménylista foglalási űrlapja](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-esemenylista/)
- [Az eseménynaptár foglalási űrlapja](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-esemenynaptar/)
- [Foglalási egyéni mezők](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-egyeni-mezok/)
- [A lépésenkénti foglalási űrlap működése](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-lepesenkenti-urlap/)
- [A katalógus foglalási űrlap](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-katalogus/)
- [Foglalási űrlap felugró ablakban](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-felugro-ablak/)
- [Az Amelia használata oldalszerkesztőkkel](https://hub.hellowp.io/hu/plugins/ameliabooking/foglalasi-urlapok-szerkesztok/)

![A Testreszabás oldal az űrlaptípusokkal](./kepek/lista-testreszabas.webp)

*A Testreszabás oldal az űrlaptípusokkal* (https://minta-bolt.hu/wp-admin/admin.php?page=wpamelia-customize)

Az űrlapok megjelenését az **Amelia → Testreszabás** oldalon állíthatod: itt választhatsz a **Lépésről lépésre**, a **Katalógus** és az **Eseménylista** űrlap között, és módosíthatod a színeiket, feliratukat, láthatóságukat és az elemek sorrendjét.

## Shortcode-ok

| Űrlap | Shortcode |
| --- | --- |
| Lépésenkénti foglalás | `[ameliastepbooking]` |
| Katalógus | `[ameliacatalogbooking]` |
| Eseménylista | `[ameliaeventslistbooking]` |
| Eseménynaptár | `[ameliaeventscalendarbooking]` |
| Vásárlói felület | `[ameliacustomerpanel appointments=1 events=1]` |
| Munkavállalói felület | `[ameliaemployeepanel appointments=1 events=1]` |

A vásárlói és a munkavállalói felülethez legalább az `appointments=1` vagy az `events=1` paraméter kell, különben a shortcode nem tölt be. A munkavállalói felületen a `profile-hidden=1` megakadályozza, hogy a munkavállalók elérjék a profilbeállításaikat.

### Paraméterek

A paraméterek szűrik vagy módosítják, mit lát a látogató. Több érték vesszővel elválasztott listaként adható meg, a nem támogatott kombinációkat a rendszer figyelmen kívül hagyja.

| Paraméter | Hatás |
| --- | --- |
| `service` | Csak a megadott szolgáltatások. |
| `category` | Csak a megadott kategóriák. |
| `employee` | A megadott munkavállalók szolgáltatásai. |
| `location` | A megadott helyszínek. |
| `tag` | A megadott címkéjű szolgáltatások vagy események. |
| `event` | Egy adott esemény azonosító alapján. |
| `recurring` | Az `event` paraméterrel együtt az ismétlődő alkalmakat is mutatja. |
| `show` | `services` vagy `packages`: szolgáltatások vagy csomagok megjelenítése, ha mindkettő be van kapcsolva. |
| `package` | Katalógusban egy adott csomag megjelenítése. |
| `range` | Az eseménylistán `future` (közelgő), `past` (múltbeli) vagy dátumtartomány, `ÉÉÉÉ-HH-NN - ÉÉÉÉ-HH-NN` formában, a kötőjel két oldalán szóközzel. |

Példák:

```text
[ameliastepbooking]
[ameliastepbooking category=3]
[ameliastepbooking service=1]
[ameliastepbooking employee=1,3,7]
[ameliastepbooking employee=2 location=1]
[ameliastepbooking category=1 employee=1]
[ameliastepbooking show=services]
[ameliastepbooking show=packages]
[ameliacatalogbooking]
[ameliacatalogbooking category=1 employee=1]
[ameliacatalogbooking service=1]
[ameliacatalogbooking location=1]
[ameliacatalogbooking show=packages]
[ameliacatalogbooking package=1]
[ameliaeventslistbooking range="future"]
[ameliaeventslistbooking range="2026-04-07 - 2026-05-20"]
[ameliaeventslistbooking range="past"]
[ameliaeventslistbooking event=1]
[ameliaeventslistbooking event=1 recurring=1]
[ameliaeventslistbooking tag="{physics}"]
[ameliaeventscalendarbooking]
[ameliaeventscalendarbooking event=1]
[ameliaeventscalendarbooking event=1 recurring=1]
[ameliaeventscalendarbooking tag="{workshop}"]
[ameliacustomerpanel appointments=1]
[ameliacustomerpanel events=1]
[ameliacustomerpanel appointments=1 events=1]
[ameliaemployeepanel appointments=1 profile-hidden=1]
```

A `range="future"` a ma későbbi órákra eső eseményeket is mutatja, a `range="past"` pedig a ma korábbi órákra esőket is.

Több címke: `tag="{design},{marketing}"`.

Az űrlap felugró ablakban is megnyitható: a `trigger=` és a `trigger_type=` (class vagy id) paraméterrel megadod az elemet, amelyre kattintva megnyílik, az `in_dialog=1` pedig az Amelia párbeszédpanel-elrendezésében jeleníti meg.

### Előválasztás URL-paraméterekkel

A foglalási űrlapokat és az eseménylistákat az oldal URL-jének paramétereivel is előszűrheted:

| Paraméter | Hatás |
| --- | --- |
| `ameliaEventId` | Esemény azonosítója alapján szűr. |
| `ameliaEventTag` | Eseménycímke alapján szűr. |
| `ameliaServiceId` | Szolgáltatás alapján szűr. |
| `ameliaEmployeeId` | Munkavállaló alapján szűr. |
| `ameliaCategoryId` | Kategória alapján szűr. |
| `ameliaLocationId` | Helyszín alapján szűr (csak szolgáltatásalapú űrlapoknál, eseményeknél nem). |
| `ameliaEventPopup` | A megadott azonosítójú esemény felugró ablakban nyílik meg az oldal betöltésekor. |

Az azonosítókat vesszővel elválasztott listaként is megadhatod. Például az `https://pelda.hu/foglalas/?ameliaServiceId=5&ameliaEmployeeId=1` címen az űrlap az 5-ös azonosítójú szolgáltatást és az 1-es munkavállalót választja elő. Az `https://pelda.hu/esemenyek/?ameliaEventId=123&ameliaEventPopup=123` címen pedig az eseményt listázó oldal betöltésekor a 123-as esemény adatai automatikusan felugró ablakban megjelennek.

## A lépésenkénti űrlap

![A lépésenkénti foglalási űrlap a weboldalon](./kepek/urlap-lepesenkenti.webp)

*A lépésenkénti foglalási űrlap a weboldalon* (https://minta-bolt.hu/idopontfoglalas/)

A lépésenkénti űrlap végigvezeti a vásárlót a szolgáltatás kiválasztásán, az időpont megadásán, az adatai megadásán és a fizetésen. A képen a **Dátum és idő** lépés látszik, mivel a bemutató oldalon csak egy szolgáltatás és egy munkavállaló van, így az első lépés kimarad. A bal oldali sáv mutatja a lépéseket (**Dátum és idő**, **Az adataid**, **Fizetések**).

- **Elrendezés**: kétféle van. A lista elrendezésben az első lépésben egyszerre látszik a szolgáltatás, a munkavállaló és a helyszín választó. A lépések elrendezésben az első képernyő három lépésre bomlik. Az **Amelia → Testreszabás → Lépésről lépésre** oldalon váltható, a további lépések ugyanazok.
- **Első lépés**: alkalmazkodik a beállításaidhoz. Ha csak egy szolgáltatás, munkavállaló vagy helyszín van, az a mező kimarad. Több lehetőségnél a legördülők szűrőként működnek: egy munkavállaló kiválasztása leszűkíti a szolgáltatásokat és helyszíneket. Ha a szolgáltatás tagja egy csomagnak, a megfelelő licencnél itt csomagjavaslatok jelennek meg.
- **Csomag foglalása**: ha a vásárló csomagot választ, látja a benne lévő szolgáltatásokat és a szükséges időpontok számát, és a csomagban megadott minimális és maximális szabályok szerint foglal egyenként. A maradék időpontokat később a vásárlói felületen ütemezheti. A csomagfoglalás mindig egy főre szól, és ismétlődő időpont sem kínálható hozzá.
- **Extrák**: ha a szolgáltatáshoz vannak extrák, az első lépés után jelenek meg, és módosíthatják az időtartamot és az árat.
- **Vendégek hozása**: ha a szolgáltatás csoportos foglalást enged, a vásárló megadhatja, hogy egyedül vagy vendégekkel foglal. A csomag részeként foglalt szolgáltatásnál ez a lépés kimarad.
- **Dátum és idő**: csak a szabad időpontokat mutatja, a szolgáltatás hosszát, a pufferidőket, a munkavállaló munkaidejét, a különleges napokat, a szabadnapokat és a helyszíneket figyelembe véve. Ha az ismétlődő időpontok be vannak kapcsolva, a vásárlót megkérdezi, ismétlődjön-e az időpont.
- **Az adataid**: név, vezetéknév, e-mail-cím és telefonszám. A **Testreszabás → Lépésről lépésre** oldalon kötelezővé vagy opcionálissá tehetők. Itt jelennek meg a szolgáltatáshoz rendelt egyéni mezők is.
- **Fizetés**: ha a szolgáltatás fizetős, megjelenik a fizetési lépés: kuponok alkalmazhatók (ha be vannak kapcsolva), és választhatók a globálisan vagy szolgáltatásonként engedélyezett fizetési módok. Egyes szolgáltatóknál (Stripe, Square, PayPal) az űrlapon belül fizet a vásárló, másoknál (WooCommerce, Mollie, Razorpay, Barion) külső fizetőoldalra irányítja az Amelia. Az ingyenes szolgáltatások kihagyják ezt a lépést.
- **Visszaigazolás**: az összefoglaló képernyő az időpont adataival és naptárhoz adás gombokkal (Google, Outlook, Yahoo, Apple). Ez nem azonos a naptár-integrációkkal, azok nélkül is működik, és csak a vásárló saját naptárához ad egy eseményt. Ha a vásárlói felület be van kapcsolva, egy gomb oda is vezet. A **Befejezés** gomb frissíti az oldalt, vagy az **Általános** beállításokban megadott egyedi URL-re irányít.

## Az eseménylista

![Az eseménylista űrlap a weboldalon](./kepek/urlap-esemenylista.webp)

*Az eseménylista űrlap a weboldalon* (https://minta-bolt.hu/esemenyek/)

Az eseménylista az eseményeket egyszerű, függőleges listában mutatja. A képen az esemény kártyája látható: dátum, idő, név, a foglalás állapota (**Megnyitás**), a szabad helyek száma, az ár (**Ingyenes**) és a **Bővebben** gomb. A kereső és a **Szűrők** gomb az események szűkítésére szolgál. A lista oldalankénti elemszámát a **Beállítások → Általános** oldalon adhatod meg.