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
Szekció neve “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 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
Szekció neve “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 fejezet írja le.

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
Szekció neve “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%
Szekció neve “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%
Szekció neve “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:
- A cél oldalra tegyél egy Dynamic Link widgetet.
- Hagyd az alapbeállításokat, és a Label mezőbe írd a
%query_var|field-name%makrót, afield-namehelyére az űrlapmező nevével. - 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%
Szekció neve “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 awp_poststá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%
Szekció neve “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 fejezet Query Results Count részénél olvashatod.
Rövidkód eredménye: %shortcode_result%
Szekció neve “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%
Szekció neve “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
Szekció neve “Makrók a kapcsolatokhoz”A kapcsolatok makróit a Makrók a kapcsolatokhoz 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
Szekció neve “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
Szekció neve “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
Szekció neve “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
Szekció neve “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
Szekció neve “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:
%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
Szekció neve “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
Szekció neve “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
Szekció neve “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 (<span></span>, <div></div>). 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 <img src="%media-field|img_url_by_id%"> 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
Szekció neve “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: <img src="%media-field|img_url_by_id%">. 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 anamehelyére a Repeatable Fields Group Start típusú mező nevét írd. - A
media-fieldés apost-fieldré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.
Készült: