Makrók

A makró egy szövegrészlet, amelyet a JetEngine a környezettől függő értékkel helyettesít. A makrókkal lekérdezhetsz és kiírhatsz dinamikus adatokat. A csatolmány-hivatkozás visszahívás mellett a Customize field output mezőben (Dynamic Field) is használhatod őket. Ha csak a fájl URL-jére van szükséged hivatkozás nélkül, a %media-field|file_url_by_id% makró a csatolmány linkjét adja vissza (lásd lent).

Hol használhatók

A legtöbb makró globális, ezek a következő helyeken működnek:

• a Lekérdezéskészítőben (Query Builder),
• a dinamikus láthatóság beállításaiban,
• a Dynamic Link elem Label és Query Arguments mezőjében,
• a Dynamic Field elem Customize field output mezőjében.

Néhány makró csak meghatározott helyen működik: a JetBooking iCal-szinkronizálásában, a Dynamic Repeater elemben (ismétlő mezők), az űrlapok Send Email műveletében. Ezeket külön szakasz írja le lent.

Minden makrónak van törzse, környezeti értéke (context) és tartaléka (fallback). A kézzel beírható helyekre érdemes a JetEngine → JetEngine → Makrógenerátor lapon legeneráltatni a makrót: válaszd ki a makrót, a kontextust, add meg a tartalékértéket, majd másold ki az eredményt.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine

A képen a Makrók lista, a Kontextus, a Tartalékérték és az alul megjelenő generált makró látszik.

Ugyanezeket a makrókat a Dynamic Tags gomb is felkínálja. Elementorban a „Macros” dinamikus címke csak a JetEngine-elemekben (például Listing Grid, Dynamic Link) és a dinamikus címkét támogató helyeken használható. Blokkszerkesztőben a Dynamic Tags gombbal a Content → Data Source lapon válaszd a „Custom Data” forrást, a Select data to show lista tartalmazza a makrókat.

Figyelem

A dinamikus láthatóságban és a Lekérdezéskészítő egyedi lekérdezéseiben a makrót csak a Dynamic Tags gombbal választhatod ki. A kézzel beírt makró itt nem működik.

Gyakori makrók

Makró	Mit ad vissza
%current_categories%	Az aktuális bejegyzés kategóriái (csak az alapértelmezett WordPress-kategóriák). Kategória szerint kapcsolódó bejegyzésekhez a Bejegyzéslekérdezés Tax Query lapján a Terms mezőbe tedd.
%current_tags%	Az aktuális bejegyzés címkéi (csak az alapértelmezett címkék).
%current_terms% vagy `%current_terms	taxonomy_slug%`
%queried_term%	A kategória azonosítója annak archívumoldalán vagy kategória-listingelemben.
%current_id%	Az aktuális bejegyzés azonosítója. Bejegyzéslekérdezésben az aktuális bejegyzés bevonására vagy kizárására használható.
%title%	Az aktuális bejegyzés címe. A Dynamic Link Label mezőjébe írva kattintható lesz.
%object_id%	Az aktuális objektum azonosítója (Dynamic Link Label).
%field_value%	A Dynamic Link forrásaként beállított mező értéke. Ha a forrás URL-t tartalmazó meta mező, ez a hivatkozás.
`%jet_engine_field_name	meta-field
`%jet_engine_field_name	meta-field
`%current_meta	field-name%`
`%current_meta_string	field-name%`
%today%	A mai dátum időbélyegként.
`%str_to_time	datetime-string%`
`%current_date	format%`
`%option_value	name_of_option::meta_field_name%`
`%query_var	field-name%`
`%query_results	ID
`%query_count	ID
`%shortcode_result	[shortcode]%`
`%jfb_record_field	field-name%`

A %current_date formátumai

• day: a hónap napja (május 16-án 16).
• day_of_week: a hét napjának neve.
• month: a hónap neve.
• year: négyjegyű évszám.
• custom: saját formátum, például %current_date|custom|F j, H:i% eredménye „May 16, 13:11”.

A %query_var használata űrlap után

Ha az űrlap Redirect to Page művelete a bejelölt mezőket átadja az átirányítási URL-ben (Add query arguments to the redirect URL), a cél oldalra tegyél egy Dynamic Link elemet, alapbeállítással, és a Label mezőbe írd a %query_var|mezőnév% makrót. Dynamic Field elemmel a Query Variable forrást is használhatod. Az űrlap elküldése után az oldal megjeleníti a beírt adatot.

A %query_results formátumai

• ids: az elemek azonosítóinak vesszővel elválasztott listája, például a 6-os lekérdezésnél %query_results|6|ids%. Bejegyzéslekérdezés Post In mezőjébe téve egy másik lekérdezés találatait vonhatod be. Nem csak a Posts Query-vel működik.
• all: a találatok objektumainak tömbje, például %query_results|6|all%.
• selected: a megadott tulajdonságok listája, hasznos SQL-lekérdezésnél. A %query_results|6|selected|ID% az ID oszlop értékeit adja vesszővel elválasztva.

A %query_count értékei

• total: az összes találat száma (%query_count|5|total%).
• visible: az aktuális oldalon látható találatok száma (%query_count|5|visible%).

Kapcsolatok

Az alábbi makrók csak a régi típusú kapcsolatokkal működnek (azokkal, amelyek a JetEngine 2.11.0 frissítése előtt készültek). A post-type-slug helyére a bejegyzéstípus azonosítóját írd, például events.

Makró	Mit csinál
`%related_children_from	post-type-slug%`
`%related_parents_from	post-type-slug%`
`%get_grandparent	post-type-slug%`
`%get_grandchild	post-type-slug%`

Felhasználók

Makró	Mit ad vissza
%author_id%	Az aktuális bejegyzés szerzőjének azonosítója.
%queried_user_id%	A lekérdezett felhasználó azonosítója a Profile Builder oldalakon és a felhasználói listingben; máshol az aktuális felhasználóé.
%current_user_id%	A bejelentkezett felhasználó azonosítója, például a fiókoldalon a saját bejegyzések listájához.
`%current_user_meta	field-name%`

Adattárolók (Data Store)

A store-slug helyére az adattároló általad megadott azonosítóját írd.

Makró	Mit ad vissza
`%get_store	store-slug%`
`%store_count	store-slug%`
`%get_users_for_store_item	store-slug

A context értékei:

• post: alapértelmezett, az aktuális bejegyzés azonosítóját keresi (például a bejegyzést kedvelő felhasználók).
• user: az aktuális felhasználó azonosítóját keresi (például az ő követői).
• queried_user: a lekérdezett felhasználó azonosítóját (például a szerzői archívumban vagy a Profile Builder felhasználói oldalán).
• author: az aktuális bejegyzés szerzőjét (például szerzői dobozban).

Egyedi tartalomtípus (CCT)

%current_field|field_key%: a CCT listingelemben a megadott mező értékét adja. Ha nem adsz meg mezőt, az elem azonosítóját adja vissza.

WooCommerce

Ezek a makrók telepített és aktív WooCommerce esetén érhetők el. Egy részük a termék listingelemében és egyedi oldalán használható, más részük a Lekérdezéskészítő WC Product Query típusában.

Makró	Mit ad vissza
%add_to_cart_text%	A termék „Kosárba” gombjának szövege (például „Kosárba”, „Tovább”). A Dynamic Link Label mezőjébe téve, ha a forrás „Add to Cart”, kosárba helyező gombként működik.
%wc_product_title%	A termék címe. A %title% makró vagy a „WooCommerce Product Field” dinamikus címke is használható helyette.
%wc_get_products_in_cart%	A kosárban lévő termékek azonosítói; a WC Product Query Include mezőjében használható.
%wc_get_products_on_sale%	A jelenleg akciós termékek azonosítói.
%wc_purchased_products%	A bejelentkezett felhasználó korábban megvásárolt termékei.

JetAppointment

Ezek a JetAppointment bővítményhez tartoznak, a JetFormBuilder űrlapok vagy a JetEngine Forms (régi) Send Email utólagos műveletében jelenítik meg az időpontfoglalás adatait.

• %service_title%, %provider_title%: a szolgáltatás és a szolgáltató neve.
• %service_link%, %provider_link%: hivatkozás a szolgáltatásra és a szolgáltatóra.
• %post-field|post_title_by_id%: a bejegyzés címe; a post-field helyére az űrlapmező neve kerül.
• %appointment_start%, %appointment_end%: az időpont kezdete és vége. Formátum adható meg, például %appointment_start|format_date(F j, Y g:i)%.
• %user_local_time%, %user_local_date%, %user_timezone%: a felhasználó időzónájában megadott idő, dátum és maga az időzóna (például „America/Vancouver”), ha az időzónakezelés be van kapcsolva.
• %appointment_price%: a lefoglalt időpont ára.
• %appointmens_list% … %appointmens_list_end%: több foglalás listája, ha a többszörös foglalás be van kapcsolva. A két makró közé írt szöveg és makrók minden foglalásnál megismétlődnek:

%appointmens_list%
Appointment Start: %appointment_start|format_date(F j, Y g:i)%
Appointment  End: %appointment_end|format_date(g:i)%
%appointmens_list_end%

• %appointment_meta|_cancel_url%: a lemondási hivatkozás.

JetBooking

Ezek a makrók csak telepített és aktív JetBooking mellett jelennek meg. Egy részük az iCalendar-sablonban használható (Foglalások → Naptárak), a többi dinamikus címkével Elementorban és a blokkszerkesztőben, és mind használható a Lekérdezéskészítőben.

Makró	Mit ad vissza
`%booking_accommodation_status	available-label
`%booking_column	column-name%`
%booking_cancel_url%	Az adott foglalás lemondási hivatkozása.
`%booking_data	booking-data-clarification%`
%booking_price_per_day_night%	Az egység napi vagy éjszakai ára, a foglalási időszak beállítása szerint.
%booking_status%	A foglalás belső állapota.
%booking_unit_title%	Az egység neve, ha meg van adva.
%booking_units_count%	A még foglalható egységek száma (például „2 szoba maradt”). Használható egyedi oldalon, listingben és felugró ablakban.
`%bookings_count	start-date

A %booking_price_per_day_night% további választható beállításai:

• Shown Price: Default (az árbeállítás-lap „Price per 1 day/night” mezője), Min Price vagy Max Price (az alap-, szezonális és hétvégi árakból számolva), Prices Range (a minimum és maximum közti sáv).
• Price Type: Static, vagy Dynamic, amely a kiválasztott érkezési és távozási dátum szerint számol újra. A dinamikus csak akkor működik, ha az oldalon foglalási űrlap van.
• Currency Sign és Currency Sign Position: egyedi pénznemjel, és hogy az ár előtt vagy után áll.

JetSmartFilters

A JetSmartFilters Query makró az aktív szűrők lekérdezéséből adja vissza a kiválasztott értéket. Fejlett SQL-lekérdezésekben vagy a szűrhető listingek dinamikus láthatóságában használható. A makrógenerátor Makrók listájából választhatod ki. Beállításai:

• Type: a szűrőlekérdezés melyik részét nézze. Plain Query Var: egy felső szintű paraméter (például post_type, author, post__in); Taxonomy: a kiválasztott kategóriák a tax_query felső szintjéről, a taxonómia azonosítójával; Date: dátumfeltételek a date_query-ből; Meta field: érték a meta_query-ből, a meta kulcs szerint.
• Variable Name: a keresett kulcs. Plain Query Var-nál a paraméter neve, Taxonomy-nál a taxonómia azonosítója, Meta field-nél a meta kulcs; Date típusnál hagyd üresen.
• Date Variable: Date típusnál „Before” vagy „After”: a megadott dátum előtt vagy után közzétett elemek.
• Result Format: Plain (nyers érték) vagy Prepare for SQL (az SQL-be illesztéshez előkészített érték).
• Context és Fallback: ugyanaz, mint minden makrónál.

A JetSmartFilters SEO-szabályaihoz két makró készült: a JetSmartFilters SEO Description az aktuálisan alkalmazott szűrők alapján generált SEO-leírást, a JetSmartFilters SEO Title a szűrt oldal SEO-címét adja. Dinamikus meta leírásokhoz és oldalcímekhez használhatod őket szűrt archívumoknál.

Ismétlő mezők (Dynamic Repeater)

Ezek a makrók a Dynamic Repeater elem Item Format mezőjében működnek. A mezőnevek (media-field, post-field, date-field stb.) helyére a tényleges meta kulcsot írd.

Makró	Mit csinál
%name%	Az ismétlőben lévő mező tartalma. A name helyére a meta kulcs kerül (például %text%), HTML-jelölőkkel (<span>, <div>) együtt használható.
`%media-field	img_url_by_id%`
`%gallery-field	img_gallery_grid%`
`%post_id	post_url_by_id%`
`%date-field	format_date%vagy%date-field
`%media-field	img_alt_by_id%`
`%media-field	file_url_by_id%`
`%post-field	post_title_by_id%`
`%post-field	post_titles_by_ids%`
`%post-field	post_link_by_id%`
`%checkbox-field	render_acf_checkbox%`
`%repeater-field	embed_url%`
`%term-field	term_title_by_id%`
`%term-field	term_titles_by_ids%`

Megjegyzés

A két bejegyzéscímes (post_title_by_id, post_titles_by_ids) és a két kategórianeves makrót mindig párban illeszd be, mert a felhasználó egy vagy több elemet is kiválaszthat.

Makrók az űrlapok e-mail küldésében

A JetFormBuilder vagy a JetEngine Forms modul Send Email utólagos műveletének tartalmában használhatók.

Makró	Mit csinál
%field-name%	Az űrlapmező értéke, például a text nevű szöveges mezőé %text%. Rádiógomb, lista és jelölőnégyzet mezőkkel is működik.
`%date-field	format_date%, %date-field
`%media-field	img_url_by_id%`
`%media-field	file_url_by_id%`
`%post-field	post_title_by_id%`
`%post-field	post_titles_by_ids%`
`%post-field	post_link_by_id%`
`%post_field	post_url_by_id%`
`%checkbox-field	render_acf_checkbox%`
`%term-field	term_title_by_id%, %term-field

Az ismétlő mezőket a JetEngine űrlapok külön nem tudják elküldeni. Használd a %name% makrót, de a „Repeatable Fields Group Start” típusú mező nevével.