Scriptek
Scriptek használata a template-ekben.
2021.11.19 — Posted by Webb & Flow
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
- 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}