Rövidkódok és SmartCode-ok

A rövidkódok típusai

A Fluent Forms négyféle rövidkódot használ:

Típus	Mire való
SmartCode	Adatot gyűjt a webhelyről, a felhasználói profilokból, a bejegyzések adataiból és a FluentCRM kapcsolattartóiból. Az űrlapszerkesztőben használod.
Visszaigazolási beállítások rövidkódja	A beküldött adatokat jeleníti meg: visszaigazoló oldalon, e-mailben, PDF-ben, kvízben, beküldési részletekben, bejegyzés adataiban és fizetési jelentésekben.
Segéd-rövidkód	Adatokat gyűjt és szűr, beküldéseket számol, fizetési állapotot ellenőriz, és az URL-paramétereket jeleníti meg a beküldés után.
Feltételes rövidkód	Visszaigazolásban, e-mail-értesítésben és PDF-ben tartalmat mutat vagy rejt a látogató választásai szerint.

SmartCode-ok az űrlapszerkesztőben

A SmartCode-okat az alapértelmezett értékek beállításához használod (lásd a Dinamikus alapértelmezett érték fejezetet).

Általános kódok

Kód	Mit ad
{get.input_text}	Az URL-paraméter szövege
{wp.admin_email}	A webhely adminisztrátorának e-mail-címe
{wp.site_url}	A webhely címe
{wp.site_title}	A webhely neve
{ip}	A látogató IP-címe
{date.m/d/Y}	A dátum hónap/nap/év formában
{date.d/m/Y}	A dátum nap/hónap/év formában
{user.ID}	A bejelentkezett felhasználó azonosítója
{http_referer}	Az előzőleg meglátogatott oldal
{user.display_name}	A felhasználó megjelenített neve
{user.first_name}	A felhasználó keresztneve
{user.last_name}	A felhasználó vezetékneve
{user.user_email}	A felhasználó e-mail-címe
{user.user_login}	A felhasználó felhasználóneve
{browser.name}	A böngésző, például Chrome
{random_string.elotag}	Véletlen szöveg a megadott előtaggal
{cookie.suti_neve}	A süti értéke

Beágyazott bejegyzés kódjai

Kód	Mit ad
{embed_post.ID}	A bejegyzés vagy oldal azonosítója
{embed_post.post_title}	A bejegyzés vagy oldal címe
{embed_post.permalink}	A bejegyzés vagy oldal címe (URL)

FluentCRM kódok

Ezek a kódok a FluentCRM kapcsolattartóinak adatait töltik be. A csoportban az általános kódok többsége is elérhető (például {wp.admin_email}, {wp.site_url}, {wp.site_title}, {ip}, {date.m/d/Y}, {http_referer}, a {user.…} kódok és {browser.name}), ezek mellett:

Kód	Mit ad
{user.meta.META_KULCS}	Extra felhasználói adat egy megadott metakulccsal
{browser.platform}	Az eszköz vagy operációs rendszer típusa, például Windows vagy Mac
{get.GET_PARAMETER_NEVE}	Adat az URL-ből

Segéd-rövidkódok

A segéd-rövidkódokkal az űrlap adatait a webhely bármelyik oldalán megjelenítheted: beküldésszámot, létrehozás dátumát, egy beküldés egy mezőjét vagy fizetési összesítőt.

Űrlapinformáció: fluentform_info

A rövidkódhoz mindig meg kell adni az űrlap azonosítóját (id). Az info paraméter mondja meg, mit jelenítsen meg:

info értéke	Mit ad
submission_count	A beküldések teljes száma
created_at	Az űrlap létrehozásának dátuma
updated_at	Az űrlap utolsó módosításának dátuma
payment_total	Fizetős űrlapnál a beérkezett összeg

[fluentform_info id="9" info="submission_count"]

A dátumok formátumát a date_format paraméterrel állíthatod, a PHP szabványos dátumformátum-jelöléseivel. Például a „l d F Y g A” formátum így néz ki: „Friday 17 April 2025, 10 AM”.

[fluentform_info id="9" date_format="l d F Y g A" info="created_at"]

További szűrők:

Paraméter	Értékek	Hatása
status	all (alap), read, unread	A beküldésszámot az olvasott vagy olvasatlan beküldésekre szűri
with_trashed	no (alap), yes	A kukában lévő beküldéseket kihagyja vagy beleszámolja
payment_status	all (alap), paid, pending, failed, refunded, partially-refunded, processed	Fizetős űrlapnál a fizetési állapot szerint szűr
currency_formatted	yes	A fizetett összeget pénznemjellel formázva jeleníti meg

Példa az olvasatlan beküldések számára:

[fluentform_info id="9" status="unread"]

Hátralévő helyek kijelzése

Ha az űrlapkorlátozásoknál megadtál egy legnagyobb beküldésszámot, a substract_from paraméterrel (a név így van írva) kiírhatod, hány hely maradt. Ha a korlát 20, és 5 beküldés érkezett, a kijelzett szám 15.

[fluentform_info id="9" info="submission_count" substract_from="20"]

A hide_on_zero="yes" paraméterrel a szám eltűnik, amikor eléri a nullát:

[fluentform_info id="9" info="submission_count" substract_from="20" hide_on_zero="yes"]

Egy beküldés egy mezője: ff_entry

Az ff_entry rövidkód egyetlen beküldés egy mezőjének értékét jeleníti meg. Megadod az űrlap azonosítóját (form_id), a beküldését (entry_id, például {submission.id}) és a mező nevét (field). Az is_html=false paraméterrel a kimenet nem HTML-ként értelmeződik.

[ff_entry form_id="1" entry_id="{submission.id}" field="url"]

Az adatot csak azok látják, akik a beküldéseket megtekinthetik, és maga a beküldő. Más látogatónak nem jelenik meg semmi.

URL-paraméter kiírása: ff_get

Ha az oldal címében paramétert adsz át (például oldalad.hu/oldal?my_param=hello), az ff_get rövidkóddal kiírhatod az értékét az oldalon. A példában „hello” jelenik meg.

[ff_get param="my_param"]

Feltételes rövidkódok

A feltételes rövidkóddal a visszaigazoló üzenetben, az e-mail-értesítésben és a PDF-ben a látogató válaszaitól függően jeleníthetsz meg tartalmat. Ehhez a Pro bővítmény kell.

Alapforma:

[ff_if]
    Ide írd, amit meg akarsz jeleníteni, ha a feltétel teljesül.
[/ff_if]

A rövidkódnak három paramétere van:

• field: melyik mezőt vizsgálja. A mező nevét kell megadni.
• is: a feltétel típusa.
• to: az érték, amellyel összehasonlít. Kisbetűvel írd, például ha a rádiógomb értéke „ABC”, akkor to="abc".

Példa: egy rádiógomb mezőnél csak „igen” választása esetén jelenjen meg egy üzenet:

[ff_if field="input_radio" is="equal" to="yes"]
    Örülünk, hogy tetszett a termékünk!
[/ff_if]

Ha a válasz „nem”, másik üzenet jelenik meg:

[ff_if field="input_radio" is="equal" to="no"]
    Köszönjük, hogy használod. Dolgozunk a fejlesztésen.
[/ff_if]

Feltételtípusok (is)

Érték	Jelentés
equal	Pontosan egyezik
not_equal	Nem egyezik
greater_than	Nagyobb, mint a megadott szám
less_than	Kisebb, mint a megadott szám
greater_or_equal	Nagyobb vagy egyenlő
less_or_equal	Kisebb vagy egyenlő
starts_with	A szöveg a megadott szóval kezdődik
ends_with	A szöveg a megadott szóval végződik
contains	A szöveg tartalmazza a szót vagy kifejezést
not_contains	A szöveg nem tartalmazza a szót

Annyi feltételes rövidkódot használhatsz egymás után, amennyi kell, például egy visszajelzés mezőre három külön üzenettel (to="great", to="okay", to="bad").

Egymásba ágyazott feltétel

Két feltételt egyszerre az ff_sub_if rövidkóddal vizsgálhatsz. Ennek is ugyanaz a három paramétere van (field, is, to). Példa: ha a látogató „igen”-t választott, és az értékelése nagyobb, mint 2, további szöveg jelenik meg:

[ff_if field="input_radio" is="equal" to="yes"]
    Örülünk, hogy tetszett a termékünk.

    [ff_sub_if field="ratings" is="greater_than" to="2"]
        Köszönjük az értékelést is.
    [/ff_sub_if]
[/ff_if]

[ff_if field="input_radio" is="equal" to="no"]
    Köszönjük, hogy használod. Dolgozunk a fejlesztésen.
[/ff_if]