Tovább a tartalomhoz

Tokenek (elavult)

A Tokens szintaxisa, típusai, példái és szűrői, a Text Editor with Tokens, a Shortcode with Tokens, a Discover Tokens és az Image Token.

A Token egy speciális formátumú szövegrészlet, amely helyőrzőként szolgál: megjelenéskor a bővítmény a helyére írja a dinamikusan előállított értéket (például a bejegyzés címét vagy egy egyedi mező tartalmát).

A bővítmény 3.0-s verziójától a Tokens elavult, a helyét a Dynamic Shortcodes vette át (lásd a Dynamic Shortcodes fejezetet). A meglévő tokenek tovább működnek, de új munkához a Dynamic Shortcodes ajánlott. Az átállásról az Átállás Tokensről Dynamic Shortcodesra fejezet szól.

A Tokens alapból nem feltétlenül aktív. A kapcsolója a Dynamic Content for Elementor → Funkciók oldal Tokens (Elavult) fülén van. Az oldal tetején ott áll a figyelmeztetés: a Tokens elavult, csak a visszafelé kompatibilitáshoz szükséges esetben kapcsold be.

https://minta-bolt.hu/wp-admin/admin.php?page=dce-features&tab=tokens
A Funkciók oldal Tokens (Elavult) füle

A képen három beállítás látszik:

Beállítás Mit csinál
Tokens állapota Be- vagy kikapcsolja az egész Tokens-rendszert (Bekapcsolás / Kikapcsolás).
Aktív tokenek Jelölőnégyzetek a token-típusokhoz: form, system, date, author, user, post (jet és metabox is), term, option, wp_query, query, acf, product, expr. Csak a bejelöltek működnek.
Szűrők fehérlistája Soronként egy PHP-függvény neve, amelyet szűrőként engedélyezel (lásd lejjebb).
[típus:mezőnév:almező-kulcs|ID|szűrő1|szűrő2?tartalék-szöveg]
Rész Kötelező Jelentése
[ igen nyitó jel
típus igen a token típusa (lásd lent)
: mezőnév igen natív mező vagy meta mező
: almező-kulcs nem, többször is szerepelhet ha a mező tömb vagy objektum, ezzel éred el egy elemét
` ` ID nem, egész szám
` ` szűrő nem, többször is szerepelhet
? tartalék-szöveg nem ez jelenik meg, ha a mező értéke üres vagy nincs
] igen záró jel

Post, User, Term, Option, WP_Query, Query, System, Date, Advanced Custom Fields, JetEngine, Meta Box, Expression és Form.

Token Eredmény
[post:title|esc_html] az aktuális bejegyzés címe
[post:_yoast_wpseo_metadesc] a bejegyzés meta leírása (harmadik féltől származó meta mező)
[post:_thumbnail_id|wp_get_attachment_url] a kiemelt kép URL-je
[post:_thumbnail_id|wp_get_attachment_image_src(thumbnail)|reset] a kiemelt kép bélyegképének URL-je
[post:ID|get_the_post_thumbnail(full)?] a kiemelt kép egy WordPress-függvénnyel, paraméterrel; ha nincs kiemelt kép, helyőrző kép
[post:date|strtotime|date_i18n("j F Y")] a bejegyzés dátuma egyéni formátumban
[post:date|strtotime|sum(86400)|date_i18n("Y-m-d H:i:s")] a bejegyzés dátuma plusz egy nap
[post:ID|get_the_terms("category")|wp_list_pluck("name")] a bejegyzés kategóriáinak neve
[post:type:labels:singular_name] a bejegyzéstípus egyes szám címkéje
[post:permalink] a bejegyzés URL-je (alternatíva: [post:guid])
[post:post_parent|get_the_permalink] a szülőoldal URL-je
[post:post_parent|get_the_title] a szülőoldal címe

A WooCommerce tokenek csak aktív WooCommerce mellett érhetők el. A bejegyzés-tokenek termékeknél is működnek.

Token Eredmény
[product:_price] az aktuális termék alapára
[product:_sku] az aktuális termék cikkszáma
[product:_price|Woo-tshirt-logo] a megadott cikkszámú termék alapára
Token Eredmény
[acf:my_acf_field] az ACF-mező értéke (a mező neve az ACF beállításaiban szereplő név); ismétlő sorok almezőire is működik
[acf:my_acf_field|123] a 123-as azonosítójú bejegyzés ACF-mezője
[acf:my_file:filesize|size_format(2)] egy ACF-fájlmező mérete olvasható formában, két tizedessel
[acf:my_acf_field:title] az ACF-mezőcsoport beállításban megadott címkéje
Token Eredmény
[jet:field-key] a JetEngine-mező értéke (a mezőkulcs a JetEngine beállításaiból)
[jet:field-key|123] a 123-as azonosítójú bejegyzés JetEngine-mezője
[metabox:field-name] a Meta Box mező értéke (a kulcs a Meta Box beállításaiból)
Token Eredmény
[user:first_name] a bejelentkezett felhasználó keresztneve; vendégnek üres
[user:last_name|concat('Mr ',true)] a vezetéknév előtaggal
[user:nicename|trim?Anonimous] a levágott becenév, ennek hiányában vagy vendégnél a tartalék szöveg
[user:roles] a felhasználó szerepkörei, vesszővel elválasztva
[author:display_name] az aktuális bejegyzés szerzőjének neve
[author:ID|count_user_posts] a szerző bejegyzéseinek száma (paraméterként a bejegyzéstípus neve is megadható)
Token Eredmény
[term:name] az aktuális kifejezés, vagy a bejegyzés első kifejezésének neve
[term:description|wpautop] a kifejezés leírása automatikus bekezdésekkel
[term:description|123] a 123-as azonosítójú kifejezés leírása
[term:count|123] a 123-as kifejezéshez tartozó bejegyzések száma
[term:link|last] a bejegyzés utolsó kifejezésének archívum-URL-je
[term:txtarea|artist] az „artist” taxonómia kifejezésén tárolt ACF-mező (például szövegterület) értéke
[term:term_id|category|posts|reset|get_the_title] az ugyanabban a kategóriában legutóbb közzétett bejegyzés címe
[term:thumbnail_id|wp_get_attachment_url(full)] a kifejezés meta mezőjében azonosítóval tárolt média URL-je
Token Eredmény
[option:elementor_version] a telepített Elementor verziója a rendszerbeállításokból
[option:www_user_roles:editor:name|strtoupper] a Szerkesztő szerepkör neve nagybetűvel
[option:home|wp_logout_url] a kijelentkezési URL, utána a kezdőlapra visz
[option:page_id:field_id] egy Meta Box beállítási oldal értéke
Token Eredmény
[wp_query:posts] a megjelenített oldal bejegyzéseinek azonosítói (például archívumon)
[wp_query:query_vars:paged] az aktuális lapszám (az első oldalon 0)
[query:user] az összes felhasználó megjelenítési neve
[query:user:editor] a szerkesztők listája (bármely szerepkör megadható)
[query:user:customer|options("Guest")] vevők listája egy űrlap Select mezőjének beállításaihoz, plusz egy „Guest” üres értékkel
[query:term] a kifejezések listája (alapból a kategóriák)
[query:term:post_tag] a címkék listája (más taxonómia is megadható)
[query:post] a bejegyzések címei
[query:post|count] a közzétett bejegyzések száma
[query:post:uncategorized] a kategória nélküli bejegyzések (más kifejezés is megadható)
[query:page] az oldalak listája (más egyedi bejegyzéstípus is megadható)
[query:product|options] az összes termék, Select mező beállításainak formátumában
[query:post:_thumbnail_id] a bejegyzések kiemelt képeinek azonosítói (más meta mező is megadható)
Token Eredmény
[system:get:my_query_var] a $_GET változó értéke; POST, SESSION, COOKIE és SERVER is használható
[system:cookie:my_favorite] egy süti értéke (a kedvencekhez adás widget is ezt használja)
[system:server:REMOTE_ADDR] a látogató IP-címe
[date:+1 month] a mai naptól számított egy hónap, a WordPress alapformátumában
[date|Y m d] a mai dátum egyéni formátumban
[date:user:registered] a felhasználó regisztrációs dátuma
[date:post:date:+2 days|Y-m-d H:i:s] a bejegyzés közzétételi dátuma plusz 2 nap
[ROW:var1|trim] a ROW nevű változó a saját HTML-szerkezetű widgeteken belül

Az expr típus számításokat végez, és beágyazott tokeneket is elfogad.

Token Eredmény
[expr:5+(8*2)/3] matematikai kifejezés kiszámítása
[expr:[post:my_num_val]*2] számítás dinamikus értékkel (beágyazott token)
[expr:[post:my_num_val]+[post:my_num_val]*[acf:coeff|123]] számítás több dinamikus értékkel

Az Elementor Pro űrlapjaihoz:

Token Eredmény
[form:my_field_id] a „my_field_id” azonosítójú mező értéke a beküldés után
[form:all-fields] az összes beküldött mező listája
[form:all-fields|!empty] csak a kitöltött mezők listája
[form:pdf] a PDF-generátor által készített PDF csatolása a Dynamic Email-hez
[form:pdf:url] a generált PDF URL-je
[form:pdf:title] a generált PDF címe
[query:user|options] felhasználólista az Elementor Pro mező „Options” formátumában
[query:term|options("Select a category")] ugyanez egy kezdő üres értékkel
[post:category|value] több érték (például bejegyzés-kategóriák azonosítói) vesszővel elválasztva, az Elementor Pro mező „Default Value” beállításához

Szűrőként bármelyik WordPress-, PHP- vagy saját függvényt használhatod. A szűrő a token eredményét alakítja át:

  • ha a token „Hello”-t ad, a strtoupper szűrővel „HELLO” lesz;
  • ha a token egy bejegyzés azonosítóját adja, a get_the_post_thumbnail szűrővel annak kiemelt képe jelenik meg.

A szűrők paramétert is kaphatnak. A token értékét a bővítmény automatikusan első paraméterként adja át a függvénynek (egyes függvényeknél, például az explode-nál, az utolsóként). Például:

  • substr(0,3) az eredmény első 3 karakterét adja;
  • get_the_post_thumbnail('full') a teljes méretű képet adja, nem a bélyegképet.

Több szűrőt is megadhatsz, a megadás sorrendjében futnak le egymás után. A szűrőket a | jellel válaszd el:

[post:title|sanitize_title|strtoupper|trim]

A saját szűrőd egy függvény a téma functions.php fájljában; a függvény neve a szűrő neve. Egyetlen paramétere van: a token eredménye, amely lehet szöveg, tömb, objektum vagy üres. Az új függvényt vedd fel a Szűrők fehérlistája mezőbe is (soronként egyet), hogy a Tokens használhassa.

function my_custom_token_filter( $data ) {
// itt alakítsd át az értéket
return $data;
}

A tokeneket az alábbi funkciók használják. Mind elavult jelölésű, és a Funkciók oldalon kapcsolható.

A Content csoportba tartozó widget: szövegszerkesztő, amelybe tokeneket írhatsz, így a bejegyzések, felhasználók, kifejezések, egyedi mezők és beállítások értékei jelennek meg benne. Csak rendszergazda használhatja.

A DEV csoportba tartozó widget (neve a panelen Shortcode with Tokens). Egy natív WordPress-shortcode-ot illeszthetsz be vele, amelyben tokenek lehetnek, így sokféle tartalmat adhatsz az oldalhoz kézi kódolás nélkül. Csak rendszergazda használhatja.

A Content csoportba tartozó widget: az oldalon elérhető tokenek áttekintő listáját mutatja példákkal, hogy megismerd a lehetőségeket. Csak rendszergazda használhatja.

Az Elementor dinamikus címkéi között a token minden beállításnál használhatóvá válik. Csak rendszergazda használhatja, a Dinamikus címkék fülön kapcsolható.

Egy dinamikus címke olyan tokenekhez, amelyek képet vagy más médiatartalmat adnak vissza. Ezt is a Dinamikus címkék fül tartalmazza.

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