# Makrók útmutatója
> A JetEngine makróinak teljes listája: hol használhatók, mit adnak vissza, és melyik területhez (kapcsolatok, felhasználók, adattárak, CCT, WooCommerce, ismétlő, e-mail) tartoznak.
A makró egy szövegrészlet, amelyet a rendszer a makró céljának megfelelő értékre cserél. Más szóval olyan változó, amely a környezettől függően mást ad vissza. A `%current_id%` például az aktuális objektum azonosítóját adja: egy bejegyzés oldalán az adott bejegyzésé. A makrókkal lekérdezhetsz és megjeleníthetsz dinamikus adatot az oldalon.
## Hol használhatók a makrók
A legtöbb makró globális, vagyis bárhol használható, ahol a JetEngine támogatja őket, hacsak a leírásuk mást nem mond:
- a **Lekérdezéskészítő** (Query Builder) lekérdezéseiben,
- a **Dinamikus láthatóság** beállításaiban,
- a **Dynamic Link** widget/blokk **Label** mezőjében és a lekérdezési argumentumok területén,
- a **Dynamic Field** widget/blokk **Customize field output** (kimenet testreszabása) részén.
Néhány makró csak meghatározott helyen működik: a JetBooking makrói az iCal-szinkron beállításaiban, az ismétlő makrói a **Dynamic Repeater** elemben, az e-mail makrói pedig az űrlapok **Send Email** (e-mail küldése) utóműveletében.
*A Lekérdezések listája és az új lekérdezés űrlapja a Lekérdezéskészítőben* (https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-query&query_action=add)
A képen az új lekérdezés űrlapja látszik. A makrókat használó mezők mellett egy adatbázis ikon található: erre kattintva választhatsz a makrók listájából.
### A makró felépítése és a makrógenerátor
A makrónak teste, **kontextusa** és **tartalékértéke** (fallback) van. A makrót érdemes a **JetEngine → JetEngine → Makrógenerátor** fülön előállítani: ott megadod a beállításokat, a kész makrót pedig kimásolod, és beilleszted azokra a helyekre, ahol kézzel beírt makró is használható (a **Dynamic Link** **Label** mezője és lekérdezési argumentumai, a **Dynamic Field** **Customize field output** része). A generátort a [Shortcode- és makrógenerátor](https://hub.hellowp.io/hu/plugins/jet-engine/generatorok/) fejezet írja le.
*A Makrógenerátor fül* (https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine)
A makrók a **Dinamikus címkék** gomb alól is elérhetők:
- Elementorban a **Macros** dinamikus címkével, de csak JetEngine-widgetekben (például **Listing Grid**, **Dynamic Link**) és olyan funkciókban, amelyek támogatják a dinamikus címkéket (például a bejegyzéslekérdezés beállításai).
- A blokkszerkesztőben a **Dynamic Tags** gombbal, a **Content → Data Source** fülön a **Custom Data** forrás választásával; a **Select data to show** listában vannak a makrók.
**Fontos:** a Dinamikus láthatóságban és a Lekérdezéskészítő egyéni lekérdezéseiben a makrót csak a **Dynamic Tags** (adatbázis) gombbal szabad kiválasztani. A kézzel begépelt makrót ezek a helyek nem támogatják.
## Gyakran használt makrók
A makrók kódja, megnevezése a listában (zárójelben) és működése:
| Makró | Mit ad vissza |
|---|---|
| `%current_categories%` (Current categories) | Az aktuális bejegyzés kategóriái. Egy bejegyzéslekérdezés **Tax Query** fülének **Terms** mezőjében használva a kategória szerint kapcsolódó bejegyzéseket mutatja. Csak az alapértelmezett WordPress-kategóriákkal működik. |
| `%current_tags%` (Current tags) | Az aktuális bejegyzés címkéi, ugyanúgy használható, mint az előző. Csak az alapértelmezett WordPress-címkékkel működik. |
| `%current_terms%` (Current terms) | Az aktuális bejegyzés kifejezései. Megadhatsz taxonómiát: `%current_terms\|taxonomy_slug%`. Egyedi taxonómiánál ezzel jeleníthetők meg az egyező kifejezésű bejegyzések. |
| `%queried_term%` (Queried term) | A kifejezés azonosítója a saját archívumoldalán vagy a kifejezések listázási elemében. |
| `%current_id%` (Current ID) | Az aktuális bejegyzés azonosítója. Bejegyzéslekérdezésben az aktuális bejegyzés felvételére vagy kizárására való. |
| `%title%` (Title) | Az aktuális bejegyzés neve. A **Dynamic Link** **Label** mezőjébe írva kattinthatóvá teszi. |
| `%object_id%` (Object ID) | Az aktuális objektum azonosítója, a **Dynamic Link** **Label** mezőjében. |
| `%field_value%` (Field value) | A **Dynamic Link** forrásaként kiválasztott mező értéke. Ha például egy URL-metamező a forrás, ez a hivatkozást adja. |
| `%jet_engine_field_name\|meta-field\|field_name%` | A JetEngine metamező kulcsa. A `meta-field` helyére a tényleges mezőnevet írd. |
| `%jet_engine_field_name\|meta-field\|field_value%` | Ugyanaz, de a metamező értékét adja a neve helyett. |
| `%current_meta\|field-name%` (Current meta value) | Az aktuális bejegyzés metamezőjének értéke. A `field-name` a mező neve. Segítségével az aktuális bejegyzéssel azonos metaértékű bejegyzéseket is megjeleníthetsz. |
| `%current_meta_string\|field-name%` (Current meta value as string) | A tömb típusú metamező vesszővel elválasztott értékei (például többszörös választás, vagy „Mentés tömbként” bekapcsolt jelölőnégyzetek). A **Posts** metamezőből is ezzel jeleníthetsz meg bejegyzéseket. |
| `%today%` (Today) | A mai dátum időbélyegként. |
| `%str_to_time\|datetime-string%` (String to timestamp) | Időbélyeggé alakítja az értéket. Például `%str_to_time\|10 September 2000%` vagy `%str_to_time\|+ 1 day%` (holnap). |
| `%option_value\|name_of_option::meta_field_name%` (Option value) | Egy beállítóoldal metamezőjének értéke. A `name_of_option` helyére a beállítóoldal slugját írd (az oldal URL-jében találod), a `meta_field_name` helyére a mező nevét. |
### Az aktuális dátum: `%current_date%`
A `%current_date|format%` makró az aktuális napot adja a megadott formátumban. A `format` értéke:
| Érték | Eredmény (példa) |
|---|---|
| `day` | A hónap aktuális napja, például „16”. |
| `day_of_week` | A hét napjának neve, például „Tuesday”. |
| `month` | A hónap neve, például „May”. |
| `year` | Négyjegyű évszám, például „2023”. |
| `custom` | Az aktuális dátum és idő az általad megadott formátumban: `%current_date\|custom\|F j, H:i%` például „May 16, 13:11”. A formátumjelölések a WordPress dátum- és időformátumai. |
### URL-paraméter: `%query_var%`
A `%query_var|field-name%` makró az URL egy paraméterének értékét adja. A `?s=books` címből a „books” értéket a `%query_var|s%` hozza.
Hasznos az **Űrlap** **Redirect to Page** (átirányítás oldalra) utóműveleténél: ha bekapcsolod az **Add query arguments to the redirect URL** (lekérdezési argumentumok hozzáadása az átirányítási URL-hez) opciót és kijelölsz mezőket, a cél statikus oldalon megjelenítheted a beküldött értékeket:
1. A cél oldalra tegyél egy **Dynamic Link** widgetet.
2. Hagyd az alapbeállításokat, és a **Label** mezőbe írd a `%query_var|field-name%` makrót, a `field-name` helyére az űrlapmező nevével.
3. Alternatívaként használhatsz **Dynamic Field** widgetet/blokkot a **Query Variable** forrással.
Az űrlap elküldése után a felhasználó arra az oldalra kerül, ahol a mező beírt értéke megjelenik.
### Lekérdezés eredménye másik lekérdezésben: `%query_results%`
A `%query_results|ID|format%` (Query Results) makró egy Lekérdezéskészítő-lekérdezés eredményét adja, így egy lekérdezés találatait felhasználhatod egy másik lekérdezés beállításában. Két paramétert kell megadnod: az `ID` a lekérdezés azonosítója (a szerkesztő oldal URL-jében látható), a `format` pedig a következők egyike:
- `ids`: az elemek azonosítóinak listája. Ha például a 6-os azonosítójú bejegyzéslekérdezés találatai a 1705, 1706 és 1707 azonosítójú bejegyzések, a `%query_results|6|ids%` makró „1705,1706,1707” értéket ad. Egy másik bejegyzéslekérdezés **Post In** mezőjébe téve ezeket a bejegyzéseket veszi fel. Nem csak bejegyzéslekérdezésnél működik, más típusú lekérdezések azonosítóit is kiadja.
- `all`: az eredményből az objektumok tömbje.
- `selected`: a kiválasztott tulajdonságok listája. SQL-lekérdezéseknél hasznos. Ha például a 6-os SQL-lekérdezés a `wp_posts` tábla sorait adja, a `%query_results|6|selected|ID%` az azonosítók vesszős listáját adja, amelyet egy bejegyzéslekérdezés **Post In** mezőjébe (**Post & Page** fül) téve a bejegyzések listáját kapod az SQL eredményéből.
A makrót a Lekérdezéskészítőben a **Dynamic Tags** listából kell kiválasztani.
### A találatok száma: `%query_count%`
A `%query_count|ID|returned_count%` (Query Results Count) a lekérdezés találatainak számát adja. Az `ID` a lekérdezés azonosítója, a `returned_count` pedig:
- `total`: az összes találat száma (például `%query_count|5|total%`);
- `visible`: az aktuális oldalon látható találatok száma (például `%query_count|5|visible%`).
A használatot a [Dinamikus címkék](https://hub.hellowp.io/hu/plugins/jet-engine/dinamikus-tartalom-dinamikus-cimkek/) fejezet **Query Results Count** részénél olvashatod.
### Rövidkód eredménye: `%shortcode_result%`
A `%shortcode_result|[shortcode]%` (Shortcode Result) makró a megadott rövidkód értékét adja vissza. A `[shortcode]` helyére a valódi rövidkódot írd. Így a Lekérdezéskészítőben rövidkód eredményét is használhatod a lekérdezés beállításához, például ha egy rövidkód bizonyos bejegyzésazonosítókat ad. A makrót itt is a **Dynamic Tags** listából kell kiválasztani.
### JetFormBuilder-rekord: `%jfb_record_field%`
A `%jfb_record_field|field-name%` (JetFormBuilder Record Field) a rögzített űrlapmező értékét adja. Csak a JetFormBuilder-rekordok lekérdezéséhez készült listázási sablonban működik. A `field-name` az űrlapmező neve. Ha a mező értéke tömb, adj meg elérési utat: `field_name/0`, `field_name/1/nested_key` vagy `field_name/nested_key`.
## Makrók a kapcsolatokhoz
A kapcsolatok makróit a [Makrók a kapcsolatokhoz](https://hub.hellowp.io/hu/plugins/jet-engine/kapcsolatok-makrok/) fejezet írja le. A következők csak a régi kapcsolatokkal működnek (azokkal, amelyek a 2.11.0-s frissítés előtt készültek):
| Makró | Mit csinál |
|---|---|
| `%related_children_from\|post-type-slug%` (Related children from) | Csak a gyermek kapcsolt bejegyzéseket mutatja. A **Listing Grid** bejegyzéslekérdezésében (**Posts Parameters** típusú új tétel) használod. A `post-type-slug` a bejegyzéstípus slugja, például „events”. |
| `%related_parents_from\|post-type-slug%` (Related parents from) | Csak a szülő kapcsolt bejegyzéseket mutatja, ugyanúgy használva. |
| `%get_grandparent\|post-type-slug%` (Get grandparent) | Két meglévő kapcsolatot köt össze, a nagyszülő bejegyzéseket jeleníti meg. Példa: három bejegyzéstípus, Országok, Kontinensek és Túrák; a Kontinensek és a Túrák között így hozhatsz létre nagyszülő-kapcsolatot. |
| `%get_grandchild\|post-type-slug%` | A nagyszülő megfelelője: az unoka bejegyzéseket mutatja. Fordított irányban működik: az egyedi túraoldalon a kontinensek listájához a `%get_grandparent\|from-post-type%` makrót használd. |
## Makrók a felhasználókhoz
| Makró | Mit ad vissza |
|---|---|
| `%author_id%` (Post author ID) | Az aktuális bejegyzés szerzőjének azonosítója. A bejegyzés szerzőjének megjelenítéséhez. |
| `%queried_user_id%` (Queried user ID) | A lekérdezett felhasználó azonosítója, de csak a Profilkészítő oldalain és a felhasználók listájában. Máshol az aktuális felhasználó azonosítóját adja. A nyilvános profiloldalon a felhasználó bejegyzéseinek megjelenítéséhez használható. |
| `%current_user_id%` (Current user ID) | A bejelentkezett felhasználó azonosítója. A fiókoldalon a saját bejegyzések megjelenítéséhez használható. |
| `%current_user_meta\|field-name%` (Current user meta) | Az aktuális felhasználó metamezőjének értéke. A `field-name` helyére a mező neve kerül. |
## Makrók az adattárakhoz
A makrókban a `store-slug` helyére az adattár slugját írd.
| Makró | Mit ad vissza |
|---|---|
| `%get_store\|store-slug%` (Get store) | Az aktuális felhasználó által az adattárba tett objektumok azonosítói. |
| `%store_count\|store-slug%` (Store count) | Az aktuális felhasználó adattárában lévő elemek száma. |
| `%get_users_for_store_item\|store-slug\|context%` (Get users from store item) | Azoknak a felhasználóknak az azonosítói, akik a bejegyzést vagy felhasználót a saját adattárukba tették. Csak felhasználói adattárral működik. |
Ha követési rendszert építesz, a `%get_store%` a felhasználó által követetteket adja, a `%get_users_for_store_item%` pedig az aktuális felhasználó követőit. A `context` azt adja meg, hol keresse a bővítmény az aktuális elem azonosítóját. Négy értéke van:
- `post`: az alapértelmezett, ha a második paramétert nem adod meg. Az aktuális bejegyzés azonosítóját használja, így kiadhatod a bejegyzést kedvelő vagy könyvjelzőző felhasználók listáját.
- `user`: az aktuális felhasználó azonosítóját használja, vagyis az aktuális felhasználó követőit.
- `queried_user`: a lekérdezett felhasználó azonosítóját használja, tehát egy szerző követőit a szerzői archívumsablonban, vagy a Profilkészítő felhasználóoldalán.
- `author`: az aktuális bejegyzés szerzőjének azonosítóját használja. A szerzői doboznál a szerző követőit adja. A **Context** beállítás az összes dinamikus widgeten és a felhasználói dinamikus címkén is megvan, így szerzői dobozt külön listázás nélkül is összeállíthatsz.
## Makró az egyedi tartalomtípusokhoz
A `%current_field|field_key%` makró a CCT listázási elemeihez való. Az adott CCT-mező értékét adja, mezőnév nélkül pedig az elem azonosítóját.
## Makrók a WooCommerce-hez
Csak akkor érhetők el, ha a WooCommerce telepítve és aktív. Egyik részük a termék listázási elemének és egyedi oldalának adataihoz való, mások a **WC Product Query** lekérdezésben használhatók.
| Makró | Mit ad vissza |
|---|---|
| `%add_to_cart_text%` (Add to Cart Text) | A termék „Kosárba” gombjának szövege („Add to Cart”, „Read More” stb.). A **Dynamic Link** **Label** mezőjébe írható; ha a link forrása az **Add to Cart**, a link kosárba gombként működik. |
| `%wc_product_title%` (WC Product Title) | A WooCommerce-termék neve, a **Dynamic Link** **Label** mezőjébe. Helyette használhatod a `%title%` makrót vagy a **WooCommerce Product Field** dinamikus címkét is (a **Title** beállítással). |
| `%wc_get_products_in_cart%` (WC Products in Cart) | A kosárban lévő termékek azonosítói. A **WC Product Query** **Include** mezőjében a kosár tartalmát kérheted le. |
| `%wc_get_products_on_sale%` (WC Products On Sale) | Az összes jelenleg akciós termék azonosítója. |
| `%wc_purchased_products%` (WC Purchased Products) | A bejelentkezett felhasználó korábban megvásárolt termékeinek listája. |
## Makrók a JetAppointmenthez
Ezek a JetAppointment bővítményhez tartoznak, és a JetFormBuilder űrlapok vagy a (régi) JetEngine-űrlapok **Send Email** utóműveletében jelenítik meg a foglalás adatait.
| Makró | Mit ad vissza |
|---|---|
| `%service_title%` | A szolgáltatás neve. |
| `%provider_title%` | A szolgáltató neve. |
| `%post-field\|post_title_by_id%` | A bejegyzés címe; a `post-field` helyére az űrlapmező neve kerül. |
| `%service_link%` | A szolgáltatás linkje. |
| `%provider_link%` | A szolgáltató linkje. |
| `%appointment_start%` | A foglalás kezdete. Dátumformátumot is megadhatsz: `%appointment_start\|format_date(F j, Y g:i)%`. |
| `%appointment_end%` | A foglalás vége, ugyanígy formázható. |
| `%user_local_time%` | A foglalás ideje a felhasználó időzónájában, ha az időzónakezelés be van kapcsolva. |
| `%user_local_date%` | A foglalás dátuma a felhasználó időzónájában, ha az időzónakezelés be van kapcsolva. |
| `%user_timezone%` | A felhasználó időzónája, ha az időzónakezelés be van kapcsolva, például „America/Vancouver”. |
| `%appointment_price%` | Az adott foglalás ára. |
| `%appointment_meta\|_cancel_url%` | A lemondás linkje. |
A `%appointmens_list%` és a `%appointmens_list_end%` (a bővítmény így írja) közé írt szöveg minden foglalásra megismétlődik, ha a **Multi Booking** be van kapcsolva a JetAppointment **Working Hours** fülén. Példa:
```text
%appointmens_list%
Appointment Start: %appointment_start|format_date(F j, Y g:i)%
Appointment End: %appointment_end|format_date(g:i)%
%appointmens_list_end%
```
## Makrók a JetBookinghoz
Csak akkor jelennek meg, ha a JetBooking telepítve és aktív. Egy részük a **Bookings → Calendars** alatti iCalendar-sablonokhoz készült, de a Dinamikus címkékkel az Elementorban és a blokkszerkesztőben is beilleszthetők, és mind támogatott a Lekérdezéskészítőben.
| Makró | Mit ad vissza |
|---|---|
| `%booking_accommodation_status\|available-label\|pending-label\|reserved-label%` (Booking Accommodation Status) | A foglalási példány állapota a következő hét napra nézve. Teljesen foglalt időszakra „reserved”, részleges szabadságra „pending” vagy „available soon” (a pontos szabad dátummal). A dátumformátum a **Beállítások → Általános** **Dátumformátum** beállítását követi. A három címke (**Available Label**, **Pending Label**, **Reserved Label**) egyedileg megadható. Az egyedi példányoldalon vagy a foglalási példányokat listázó listázási sablonban használható. |
| `%booking_column\|column-name%` (Booking Additional Column) | A foglalás további oszlopának értéke (például „guest”). Az oszlopot a foglalás beállításakor vagy a **Bookings → Settings → Tools** fülön lehet felvenni. Az iCalendar-sablonokban használható. |
| `%booking_cancel_url%` (Booking Cancel URL) | Az aktuális foglalás lemondási linkje. |
| `%booking_data\|booking-data-clarification%` (Booking Data) | A foglalás adata: „ID”, „Instance”, „Order ID”, „User ID”, „User Email”, „Check In Date”, „Check In Time”, „Check Out Date” vagy „Check Out Time”. Az iCalendar-sablonokban és a blokkszerkesztő dinamikus címkéiben használható. A makrógenerátorban a „Check In/Out Date/Time” adattípusoknál megjelenik a **Data Format** mező: a **Plain** az egységes, géppel feldolgozható formátum, a **Readable** pedig bekapcsolja a **Date/Time Format** mezőt, ahol az olvasható formátumot adod meg. |
| `%booking_price_per_day_night%` (Booking Price Per Day/Night) | Egy nap vagy éjszaka ára, a **Bookings → Settings → Configuration** fülön beállított foglalási időszaktól függően. Az egyedi példányoldalon vagy a listázási sablonban használható. |
| `%booking_status%` (Booking: Status) | A foglalás belső állapota. iCalendar-sablonokban és dinamikus címkékben támogatott. |
| `%booking_unit_title%` (Booking: Unit Title) | Az egység neve, ha meg van adva. |
| `%booking_units_count%` (Booking Units Count) | A még foglalható egységek száma (például „2 rooms left”). Használható az egyedi példányoldalon, a listázási sablonban és a példányok felugró ablakában. |
| `%bookings_count\|start-date\|end-date%` (Bookings Count) | Az adott példányra megadott időszakban leadott foglalások száma. A dátumokat `Y-m-d H:i:s` vagy `Y-m-d` formátumban add meg, például `1996-04-09`. Listázásban, egyedi példánysablonban és felugró ablakban használható. |
A **Booking Price Per Day/Night** makró további beállításai:
| Beállítás | Értékek |
|---|---|
| **Shown Price** | **Default**: az **Pricing Settings** fül **Price per 1 day/night** mezőjének értéke. **Min Price** vagy **Max Price**: az alap-, szezonális és hétvégi árak közül a legkisebb vagy a legnagyobb. **Prices Range**: a legkisebb és a legnagyobb ár közti tartomány. |
| **Price Type** | **Static** vagy **Dynamic**. A dinamikus ár a kiválasztott be- és kijelentkezési dátum alapján újraszámol, és csak akkor működik, ha az oldalon ott van a foglalási űrlap. |
| **Currency Sign** | Egyedi pénznemjel. |
| **Currency Sign Position** | A pénznemjel az ár előtt vagy után áll. |
## Makrók a JetSmartFilterséhez
Ezeket a JetSmartFilters bővítményhez készítették. A **JetSmartFilters Query** makró az aktív szűrők lekérdezéséből veszi ki a kiválasztott értéket. Haladó SQL-lekérdezésekhez vagy a szűrhető listázásokon belüli dinamikus láthatósághoz használható. A **JetEngine → JetEngine → Makrógenerátor** fülön a **Makrók** listából választhatod ki.
A beállításai:
| Beállítás | Jelentése |
|---|---|
| **Type** | A szűrők lekérdezéstömbjének melyik részét vizsgálja. **Plain Query Var**: egy felső szintű lekérdezési argumentum (például `post_type`, `author`, `post__in`). **Taxonomy**: a kiválasztott kifejezések a `tax_query` felső szintű tételeiből, taxonómia-slug szerint. **Date**: a `date_query` időkorlátai. **Meta field**: egy érték a `meta_query` tömbből, adott meta kulcs alapján. |
| **Variable Name** | A kinyerendő kulcs. Plain Query Var esetén a pontos argumentumnév; Taxonomy esetén a taxonómia slugja; Date esetén üresen hagyandó; Meta field esetén a meta kulcs. |
| **Date Variable** | Date típusnál: **Before** vagy **After**, vagyis egy dátum előtt vagy után közzétett elemek. |
| **Result Format** | **Plain**: a nyers, változatlan érték. **Prepare for SQL**: az értéket SQL-feltételbe való biztonságos beillesztésre alakítja. |
| **Context** és **Fallback** | Minden makrónál ugyanazok, lásd a makrógenerátor leírását. |
Két további makró a JetSmartFilters SEO-szabályaihoz készült:
- **JetSmartFilters SEO Description**: az aktuális szűrők alapján generált SEO-leírást adja, dinamikus meta leírásokhoz a szűrt archívumoldalakon.
- **JetSmartFilters SEO Title**: az aktuális szűrt állapot SEO-címét adja, dinamikus oldalcímekhez.
## Makrók az ismétlő mezőhöz
A következő makrók a **Dynamic Repeater** widget/blokk **Item Format** (elem formátuma) mezőjében használhatók. A kódokban a `media-field`, `post-field`, `date-field`, `term-field` stb. helyére az adott metamező kulcsa kerül.
| Makró | Mit csinál |
|---|---|
| `%name%` | Az ismétlő tartalmának formázására való, HTML-jelöléssel együtt (``, ``). A `name` helyére az ismétlőben szereplő metamező kulcsa kerül: a `%text%` a „text” kulcsú mezőbe írt tartalmat jeleníti meg. |
| `%media-field\|img_url_by_id%` | A kép URL-je az adatbázisból. Magát a képet az `
` jelöléssel jelenítheted meg. A makró azonosítóval dolgozik, ezért az ismétlő **Média** mezőjében a **Field value** legyen **Media ID**. Ha **Media URL** a mező értéke, használd a `%name%` makrót. |
| `%gallery-field\|img_gallery_grid%` | Az ismétlő egyik almezőjének galériája. Csak a **Dynamic Repeater** elemmel működik; a `gallery-field` helyére a galéria mező kulcsa kerül. |
| `%post_id\|post_url_by_id%` | A bejegyzés URL-je az azonosítója alapján. A **Posts** metamezővel használható (ha nem többszörös választással van mentve). A `post_id` annak a mezőnek a kulcsa, amelyik a bejegyzés azonosítóját tartalmazza. |
| `%date-field\|format_date%` vagy `%date-field\|format_date(F j, Y)%` | A dátum átalakítása. A `date-field` a dátum/idő/dátumidő mező neve, `F j, Y` a formátum, amelyet a WordPress dátumformátumai szerint változtathatsz. Másik példa: `%date-field\|format_date(d)%` vagy `%time-field\|format_date(h)%`. |
| `%media-field\|img_alt_by_id%` | A kép alternatív szövege. |
| `%media-field\|file_url_by_id%` | A csatolmány linkje. |
| `%post-field\|post_title_by_id%` | A bejegyzés neve az azonosítója alapján (**Posts** metamező, ha nem többszörös választású). |
| `%post-field\|post_titles_by_ids%` | Több bejegyzés neve; a többszörös választású **Posts** mezőből veszi az adatot. |
| `%post-field\|post_link_by_id%` | A bejegyzés linkelt címe (ha a **Posts** mező nem többszörös választású). |
| `%checkbox-field\|render_acf_checkbox%` | Az ACF jelölőnégyzet-mező értéke. A JetEngine mezőit is megjeleníti, ha a **Save As Array** be van kapcsolva. |
| `%repeater-field\|embed_url%` | URL beágyazása, például videó. A beágyazandó linket írd egy szöveges metamezőbe az ismétlőben, majd az **Item format** mezőben használd a makrót (a `repeater-field` helyére az almező neve). **Média** metamezővel is működik, ha annak értékformátuma **Media URL**. |
| `%term-field\|term_title_by_id%` | A kifejezés neve az azonosítója alapján. |
| `%term-field\|term_titles_by_ids%` | A kifejezések nevei az azonosítóik alapján. |
A két bejegyzésnév-makrót, illetve a két kifejezésnév-makrót együtt illeszd be, mert a felhasználó egy vagy több bejegyzést, illetve kifejezést is kiválaszthat, és csak így kerül el az adat helyesen.
## Makrók az űrlapok e-mail-küldéséhez
Ezek a JetFormBuilder űrlapok, illetve a JetEngine **Űrlapok** moduljának **Send Email** utóműveletében használhatók.
| Makró | Mit csinál |
|---|---|
| `%field-name%` | Az űrlapmező értéke az e-mail tartalmában. A `field-name` helyére a mező neve kerül: egy „text” nevű szövegmezőnél `%text%`. A többválasztós mezőkkel (**Radio**, **Select**, **Checkbox**) is működik. |
| `%date-field\|format_date%` vagy `%date-field\|format_date(F j, Y)%` | A **Date** űrlapmező kimenetének formázása. A **Notification Settings** blokkban a `%date-field\|format_date%` makró a WordPress beállításaiban megadott alapértelmezett dátumformátumot veszi át. Más példa: `%date-field\|format_date(d)%`. |
| `%media-field\|img_url_by_id%` | A kép URL-je. Magát a képet az e-mailben HTML-lel jelenítheted meg: ``. A makró azonosítóval dolgozik, ezért a mediamező **Field value** beállítása legyen **Attachment ID**. Ha az **Attachment URL** értéket választod, használd a `%name%` makrót. Ha a felhasználó több képet is feltölthet, az **Attachment URL** értéket kell kiválasztanod. |
| `%media-field\|file_url_by_id%` | A csatolmány linkje. |
| `%post-field\|post_title_by_id%` | A bejegyzés címe az azonosítója alapján, a **Send Email** utóművelet **Content** mezőjében. |
| `%post-field\|post_titles_by_ids%` | Több bejegyzés neve. Ha csak egy bejegyzés van kiválasztva, üres értéket ad. |
| `%post-field\|post_link_by_id%` | A bejegyzés linkelt címe az azonosítója alapján. |
| `%post_field\|post_url_by_id%` | A bejegyzés URL-je az azonosítója alapján. |
| `%checkbox-field\|render_acf_checkbox%` | A **Checkbox** mezőben kiválasztott érték. |
| `%term-field\|term_title_by_id%` | A kifejezés neve az azonosítója alapján. |
| `%term-field\|term_titles_by_ids%` | A kifejezések nevei az azonosítóik alapján. Ha csak egy kifejezés van kiválasztva, üres értéket ad. |
Néhány tudnivaló az e-mailes makrókhoz:
- Az ismétlő mezőket a JetEngine-űrlapokon nem lehet külön elküldeni. Az ismétlő adatait a `%name%` makróval küldheted el, de a `name` helyére a **Repeatable Fields Group Start** típusú mező nevét írd.
- A `media-field` és a `post-field` részt a megjeleníteni kívánt mező nevével kell helyettesíteni.
- A bejegyzés- és kifejezésnév-makrókat (egyes és többes számú változat) mindig együtt illeszd be, mert a felhasználó egy vagy több elemet is kiválaszthat.