Jeder Block kann auch ein PHP Skript besitzen, welches automatisch eingebunden wird. Dazu muss in Ihrem site Pfad das Verzeichnis blocks existieren und hier eine PHP Datei mit dem Namen Ihres Blocks. Beispiel:
skin/<DESIGN>/blocks/my_block.tpl
site/<MANDANT>/blocks/my_block.php
Im Skript sind folgende lokale Variablen verfügbar:
- $page: Das aktuelle Page Objekt.
- $site: Das aktuelle Site Objekt.
- $auth: Das aktuelle Auth Objekt.
- $block: Bezeichnung des Blocks. Nützlich, wenn mehrere Blöcke die selben Skripte einbinden.
- $orient: Die Orientierung, in der dieser Block verwendet wird.
- $index: Die Position dieses Blocks in der verwendeten Orientierung.
- $extra: Die zugehörigen Block Einstellungen.
- $smarty: Das zugehörige Smarty Objekt. Über dieses Objekt gesetzte Variablen sind im Block Template verfügbar.
- $uid: Die eindeutige Kennung des Blocks.
- $variant: Die Variante des Blocks.
Zusätzlich stehen natürlich alle globalen Variablen über $GLOBALS zur Verfügung.
Legen Sie bei Bedarf auch eine blocks.php direkt im site Verzeichnis an, wenn Sie ein Skript für jeden Block ausführen möchten. Dieses Skript wird vor dem Block spezifischen Skript ausgeführt und kennt die selben lokalen Variablen.
Es wird empfohlen PHP Code, der Blöcke betrifft, in eine Block spezifische oder globale Block PHP Datei auszulagern. Verwenden Sie hierfür nicht die index.php, da diese nur einmal für die gesamte Seite oder den Seitentyp eingebunden wird.