Tovább a tartalomhoz

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.

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.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-query&query_action=add
A Lekérdezések listája és az új lekérdezés űrlapja a Lekérdezéskészítő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.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine
A Makrógenerátor fül

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.

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.

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.

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%

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 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 %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.

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ó 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.

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.

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.

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.

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%

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.

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.

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 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.

Készült:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások