smarty-php/smarty
1
0
Fork 0
mirror of https://github.com/smarty-php/smarty.git synced 2025-08-07 11:54:26 +02:00
Code Issues Packages Projects Releases Wiki Activity

-update of README

Browse Source
This commit is contained in:
Uwe.Tews
2009-10-02 15:30:32 +00:00
parent c4b46fe7c8
commit 3c4b99ca34
1 changed files with 17 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
README
View File

@@ -39,6 +39,7 @@ backward compatible with Smarty 2, except for the following items:
*) Delimiters surrounded by whitespace are no longer treated as Smarty tags. *) Delimiters surrounded by whitespace are no longer treated as Smarty tags.
Therefore, { foo } will not compile as a tag, you must use {foo}. This change Therefore, { foo } will not compile as a tag, you must use {foo}. This change
Makes Javascript/CSS easier to work with, eliminating the need for {literal}. Makes Javascript/CSS easier to work with, eliminating the need for {literal}.
This can be disabled by seting $smarty->$auto_literal = false;
There are many things that are new to Smarty 3. Here are the notable items: There are many things that are new to Smarty 3. Here are the notable items:
@@ -50,7 +51,7 @@ means Smarty has some syntax additions that make life easier such as in-template
math, shorter/intuitive function parameter options, infinite function recursion, math, shorter/intuitive function parameter options, infinite function recursion,
more accurate error handling, etc. more accurate error handling, etc.
OBJECTS PLUGINS
Smarty 3 plugins are now objects that extend Smarty_Internal_PluginBase. All Smarty 3 plugins are now objects that extend Smarty_Internal_PluginBase. All
plugins have the property $this->smarty available as a reference to the Smarty plugins have the property $this->smarty available as a reference to the Smarty
@@ -81,15 +82,11 @@ In PHP templates, assigned vars are available simply as:
<?php echo $foo; ?> <?php echo $foo; ?>
<?=$foo?> // php short tags <?=$foo?> // php short tags
Modifiers are used as such: You can't use Smarty modifiers from the plugin folder.
They must be implemented as PHP function.
// same as {foo|trim|truncate:50} You can call PHP functions a usual:
$foo->trim()->truncate(50); <?php echo foo($bar); ?>
Template functions are used as such:
// same as {foo bar=$baz}
$_f->foo($baz);
WHAT IS NEW IN SMARTY TEMPLATE SYNTAX WHAT IS NEW IN SMARTY TEMPLATE SYNTAX
@@ -119,11 +116,16 @@ Arrays can be nested.
There is a new "short" syntax for assigning variables. There is a new "short" syntax for assigning variables.
{$foo=$bar+2} {$foo=$bar+2}
{$foo['y']='yellow}
{$foo[]=$bar}
Arrays can be accessed now also with a new syntax. Arrays can be accessed now also with a new syntax.
{$foo['bar']} // same as {$foo.bar} {$foo['bar']} // same as {$foo.bar}
The quotes are required. This syntax addition addresses ambiguties when nesting The quotes are required. This syntax addition addresses ambiguties when nesting
the dot syntax. The dot syntax {$foo.bar} will still work. the dot syntax. The dot syntax {$foo.bar} will still work.
You can use array elements as index of other array.
{$foo['bar'][$blar['buh']['puh']}
{$foo.bar.{$blar.buh}.puh}
Variable names can be handled with variables directly. Variable names can be handled with variables directly.
{$foo_{$x}} will output the variable $foo_1 if $x has a value of 1. {$foo_{$x}} will output the variable $foo_1 if $x has a value of 1.
@@ -166,9 +168,12 @@ New {nocache} block function:
New nocache attribute: New nocache attribute:
You can declare variable/function output as non-cached with the nocache attribute. You can declare variable/function output as non-cached with the nocache attribute.
{$foo nocache=true} {$foo nocache=true} or {$foo nocache}
{foo bar="baz" nocache=true} {foo bar="baz" nocache=true} or {foo bar="baz" nocache}
{time() nocache=true} {time() nocache=true} or {time() nocache}
Or you can assign the variable already in your script as nocache:
$smarty->assign('foo',$something,true);
{$foo}
Please look through it and send any questions/suggestions/etc to the forums. Please look through it and send any questions/suggestions/etc to the forums.