Távolság megjelenítése felhasználók, kifejezések és CCT-elemek között

A JetEngine a Dynamic Field widgettel ki tudja írni, milyen messze van egy felhasználó, egy taxonómia-kifejezés vagy egy CCT-elem egy megadott címtől. A három eset felépítése azonos, csak a kódrészlet, a lekérdezés típusa és a listázás forrása különbözik.

Előfeltétel: Elementor, blokkszerkesztő vagy Bricks; aktív JetEngine bekapcsolt Térképes listák modullal; aktív JetSmartFilters.

Közös tudnivaló: ha a cím Szöveg típusú metamezőben van, vedd fel a mezőt (vagy a szélességi és hosszúsági mezőt) a JetEngine → JetEngine → Térképek beállításai fül Meta fields to preload (előre betöltendő metamezők) mezőjébe. A Térkép típusú mezőhöz ez nem kell.

Felépítés lépésről lépésre

1. Kódrészlet

Add hozzá a kódot a gyermektéma functions.php fájljához, vagy egy kódrészlet-kezelő bővítményhez (például a Code Snippets). Mentsd és aktiváld.

A típustól függően ez a kód kell:

// Felhasználók
add_filter( 'jet-engine/maps-listings/add-distance-field/users', '__return_true' );

// Taxonómia-kifejezések
add_filter( 'jet-engine/maps-listings/add-distance-field/terms', '__return_true' );

// Egyéni tartalomtípus
add_filter( 'jet-engine/maps-listings/add-distance-field/custom-content-type', '__return_true' );

2. Lekérdezés a Lekérdezéskészítőben

1. A JetEngine → Lekérdezéskészítő oldalon kattints az Új hozzáadása gombra, és add meg a lekérdezés nevét.
2. Állítsd be a típust:
   • felhasználóknál Users Query, a User Role fülön szükség szerint a szerepkört (például Subscriber),
   • kifejezéseknél Terms Query, az General fülön a taxonómiát,
   • CCT-nél Custom Content Type Query, és a From Content Type listában a CCT-t.
3. Nyisd meg a Geo Search részt (CCT-nél ez a tartalomtípus lekérdezés szakaszán belül van). A térképen jelöld ki a keresés középpontját, vagy írd be a koordinátákat.
4. Az Address Field mezőbe írd be annak a metamezőnek a nevét, amelyben a cím van (vagy két mezőét, ha a szélességi és hosszúsági fok külön mezőben van). Ez lehet Szöveg vagy Térkép típusú mező, például user_address, address_city vagy location_address.
5. Add meg a Distance értékét, amely a középpont körüli keresési sugár, és az egységet (Miles vagy Kilometers).
6. Az oldal tetején kapcsold be a Preview results kapcsolót. Ha az előnézet találataiban megjelenik a geo_query_distance érték, a lekérdezés működik.
7. Kattints a lekérdezés hozzáadására.

3. Szűrő a JetSmartFiltersben

1. Menj a Smart Filters → Add New oldalra, és nevezd el a szűrőt (például „Hely és távolság”).
2. A Filter Settings részben a Filter Type legyen User Geolocation vagy Location & Distance. Az utóbbival a látogató kézzel írja be a címet és választja ki a sugarat.
3. Töltsd ki a Filter Labels részt, és frissítsd a szűrőt.

4. Listázási elem

1. A JetEngine → Listázások/komponensek oldalon kattints az Új elem hozzáadása gombra.
2. A forrás típustól függ: Users, Terms (és a From taxonomy listában a taxonómia) vagy Egyedi tartalomtípus (a CCT kiválasztásával). Add meg a nevet és a nézetet (például Elementor), és hozd létre.
3. A szerkesztőben a Dynamic Field widgettel írd ki a szükséges adatot, például a felhasználó nevét.
4. Egy második Dynamic Field widgetben a forrás maradjon Post/Term/User/Object Data, az Object field / Meta field / Repeater key / Component prop mezőbe pedig írd be: geo_query_distance.
5. Kapcsold be a Filter field output kapcsolót, és a Callback mezőben válaszd a Format number értéket. Így a távolság két tizedesjegyre rövidül (a Decimal points alapértéke 2).
6. Kapcsold be a Customize field output kapcsolót, és a Field format mezőbe írd: Távolság: %s km. A %s helyére a számérték kerül.
7. Tedd közzé a listázási elemet.

5. Elhelyezés az oldalon

1. Nyiss meg egy oldalt (vagy hozz létre újat) a szerkesztőben.
2. Add hozzá a Listing Grid vagy a Map Listing widgetet, és a General fülön válaszd ki az imént készített listázást.
3. A Custom Query fülön kapcsold be a Use Custom Query kapcsolót, és válaszd ki az elkészített lekérdezést.
4. Adj hozzá egy Location and distance vagy User Geolocation widgetet. A Select filter mezőben válaszd ki a szűrőt, a This filter for mezőben pedig a JetEngine szolgáltatót.
5. Opcionálisan a Distance List fülön megváltoztathatod a szűrőben választható távolságokat, például 100, 200 és 500 km-re.
6. Tedd közzé az oldalt.

Az eredmény

A frontenden a szűrőben írd be a címet, és válaszd ki a sugarat a mellette lévő legördülő listában. A lista csak a megadott sugáron belüli felhasználókat, kifejezéseket vagy CCT-elemeket mutatja, a Dynamic Field pedig a távolságot is kiírja.