Scriptek

Scriptek használata a template-ekben.

2021.11.19 — Posted by Webb & Flow


Tartalomjegyzék

A script-ek előre beállított kódrészletek, amiket vagy több helyen használunk fel, vagy a tartalom szerkesztést könnyítjük meg vele, hogy ne html kódot, csak a script behívását kelljen egy tartalomba beírni.

A script-ekben elérhető minden alap és content változó, de ezeknek egy tartalmon belül mindig azonos az értéke, így ha kétszer van behívva egy script, az mindig ugyanazt írja ki ugyanarra a tartalomra.

{SCRIPT $id=ID}

Az esetben a $id változó mindenképpen a script azonosítója, nem keres név szerint.

{SCRIPT $name=NAME}

Az esetben a $name változó mindenképpen a script neve, nem keres azonosító szerint. Ezt a módszert csak akkor szabad használni, ha biztos, hogy a script-ek nem lesznek átnevezve. Akkor érdems használni, ha több változóból áll össze a script neve, és nem egyben írjuk be a template-be.

Paraméterek

A következő paraméterei lehetnek a függvénynek:

  • $id
    • kötelező, ha nincs megadva a $name
    • ha meg van adva, akkor felülbírálja a $name paramétert
    • a kiírandó script azonosítója
  • $name
    • kötelező, ha nincs megadva a $id paraméter
    • ha a $id paraméter is meg van adva, az felül fogja bírálni ezt a paramétert
    • a kiírandó script neve
  • $if
    • opcionális
    • feltételes megjelenítéshez kell
  • $notif
    • opcionális
    • feltételes megjelenítéshez kell
    • csak akkor veszi figyelembe a rendszer, ha a $if paraméter nincs megadva

A $if, illetve a $notif változókban egy ExternalData mezőt lehet behivatkozni vagy az azonosítójával vagy a nevével, és annak az értékétől függően vagy be lesz az adott script hívva, vagy sem.

A $if esetén csak akkor jelenik meg a script, ha a megadott mező logikai értéke igaz, a $notif esetén csak akkor, ha a logikai érték hamis.

A logikai érték igaz, ha:

  • szöveges mezőknél bármi meg van adva, azaz nem üres
    • TEXT
    • STRING
    • EMAIL
    • DATE
    • TIME
    • DATETIME
    • TIMESTAMP
  • szám mezőknél bármi meg van adva, ami nem 0 (a negatív szám is igaz)
    • NUMBER
    • REAL
  • lista mezőknél ha bármi ki van választva
    • BOX
    • PIC
    • FILE
    • UPLOADPIC
    • UPLOADFILE
  • yesno mezőknél, ha az Yes-re van állítva

Példa:

{SCRIPT $id=123456789 $if=YESNO1}