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

update docs

Browse Source
This commit is contained in:
mohrt
2001-01-12 21:02:55 +00:00
parent 89df5c8e38
commit a791322336
1 changed files with 130 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

135
doc.sgm
View File

@@ -132,8 +132,8 @@
<sect1>
<title>Requirements</title>
<para>
Smarty requires PHP 4. 4.0.4 contains a bug that crashes PHP when
certain Smarty features are used (such as the @count modifier). 4.0.3
Smarty requires PHP 4 or later. 4.0.4 contains a bug that crashes PHP when
the "@" modifier, such as {$var|@count}. 4.0.3
and earlier contain a bug in preg_grep() that won't allow the parser to
function properly, so to preserve performance Smarty will automatically
use built-in preg_grep() when it can and use en emulated version of it
@@ -789,7 +789,7 @@ Intro = """This is a value that spans more
with a few added features for the template engine.
Every if must be paired with /if. else and elseif are also permitted.
"eq", "ne","neq", "gt", "lt", "lte", "le", "gte" "ge","is even","is odd",
"is not even","is not odd","not","mod","even by","odd by","==","!=",">",
"is not even","is not odd","not","mod","div by","even by","odd by","==","!=",">",
"<","<=",">=" are all valid conditional qualifiers.
</para>
<example>
@@ -814,7 +814,7 @@ Intro = """This is a value that spans more
...
{/if}
{* you can also imbed php functionality, where appropriate *}
{* you can also imbed php function calls, where appropriate *}
{if count($var) gt 0}
...
{/if}
@@ -831,16 +831,26 @@ Intro = """This is a value that spans more
{/if}
{* test if var is divisable by 4 *}
{if $var is div by 4}
...
{/if}
{* same as previous example *}
{if $var is mod 4}
...
{/if}
{* test if var is even, grouped by two. i.e.,
1=even, 2=even, 3=odd, 4=odd, 5=even, 6=even, etc. *}
0=even, 1=even, 2=odd, 3=odd, 4=even, 5=even, etc. *}
{if $var is even by 2}
...
{/if}
{* 0=even, 1=even, 2=even, 3=odd, 4=odd, 5=odd, etc. *}
{if $var is even by 3}
...
{/if}
</programlisting>
</example>
</sect2>
@@ -1045,6 +1055,121 @@ e-mail: jane@mydomain.com
</programlisting>
</example>
<para>
Sections also have their own variables that handle section properties.
These are indicated by percent signs around the variable name, like so:
%sectionname.varname%
</para>
<sect3>
<title>index</title>
<para>
index is used to display the current loop iteration,
starting with zero.
</para>
<example>
<title>example: section property index</title>
<programlisting>
{section name=customer loop=$custid}
{%customer.index%} id: {$customer/custid}&lt;br&gt;
{/section}
OUTPUT:
0 id: 1000&lt;br&gt;
1 id: 1001&lt;br&gt;
2 id: 1002&lt;br&gt;
</programlisting>
</example>
</sect3>
<sect3>
<title>rownum</title>
<para>
rownum is used to display the current loop iteration,
starting with one.
</para>
<example>
<title>example: section property rownum</title>
<programlisting>
{section name=customer loop=$custid}
{%customer.rownum%} id: {$customer/custid}&lt;br&gt;
{/section}
OUTPUT:
1 id: 1000&lt;br&gt;
2 id: 1001&lt;br&gt;
3 id: 1002&lt;br&gt;
</programlisting>
</example>
</sect3>
<sect3>
<title>loop</title>
<para>
loop is used to display the total number
of iterations this section is looped. This can be used
inside or after the section.
</para>
<example>
<title>example: section property index</title>
<programlisting>
{section name=customer loop=$custid}
{%customer.index%} id: {$customer/custid}&lt;br&gt;
{/section}
There were {%customer.loop%} customers shown above.
OUTPUT:
0 id: 1000&lt;br&gt;
1 id: 1001&lt;br&gt;
2 id: 1002&lt;br&gt;
There were 3 customers shown above.
</programlisting>
</example>
</sect3>
<sect3>
<title>show</title>
<para>
show is used both as a parameter to section,
as well as displaying its value. show is a
boolean value, true or false. If false, the
section will not be displayed. If there is a
sectionelse present, that will be alternately
displayed.
</para>
<example>
<title>example: section property rownum</title>
<programlisting>
{* $show_customer_info may have been passed from the PHP
application, to regulate whether or not this section shows *}
{section name=customer loop=$custid show=$show_customer_info}
{%customer.rownum%} id: {$customer/custid}&lt;br&gt;
{/section}
{if %customer.show%}
the section was shown.
{else}
the section was not shown.
{/if}
OUTPUT:
1 id: 1000&lt;br&gt;
2 id: 1001&lt;br&gt;
3 id: 1002&lt;br&gt;
the section was shown.
</programlisting>
</example>
</sect3>
</sect2>
<sect2>
<title>strip</title>