[line 91]
TemplateTransformation is the class that Template uses internally
to handle the manipulation of values before they are substituted into a template. It is often valuable to be able to call a function or a regular expression on a value before it is shown. For instance, when you are retrieving a date value straight from your database to the template (using the [SQL: ...] directive), it is nice to be able to format it how you like, instead of how the database decides it should look.
The format of a transformation is as follows:
Tag name:Transformation type:Transformation rule
The tag name corresponds to the latter part of the name if the name is of the form ##object:property##.
There are currently three types of transformations:
func : a function call
regex: a regular expression search and replace
alternate : alternates the value of the variable between the two
provided (good for alternating background colours of table rows)
New 1.2:
Added an optional list of variables to import from the global namespace.
1 <?php 2 3 A few basic transformations: 4 5 [Transformations: 6 bgcolor:alternate:#ffffff:#eeeeee 7 icon:regex:(.+):<img src="sitellite/\1" /> 8 file_extension:func:strtoupper("##file_extension##") 9 date:func:Date::format("##date##", "F j, Y") 10 ] 11 12 Class usage: 13 14 $transformation = new TemplateTransformation ('func', 'date', 'Date::format ("##date##", "F j, Y")'); 15 16 echo $transformation->transform ('2001-12-24'); 17 18 // can also be used like this: 19 20 // note: data is the contents of a [Transformations: ...] directive 21 $transformations =& TemplateTransformation::parse ($data); 22 23 foreach ($transformations as $key => $object){ 24 // do things with $key and $object here 25 } 26 27 ?>
Sitellite Application Framework
