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

all updated for 2.6.0 release, translated everything from 2_5_0 branch to 20030908

Browse Source
This commit is contained in:
andreas
2003-09-08 16:35:05 +00:00
parent 2f42bc6159
commit dcb5caf91e
4 changed files with 1111 additions and 858 deletions
Download Patch File Download Diff File Expand all files Collapse all files

637
docs/de/designers.sgml
View File

@@ -1,7 +1,7 @@
<!-- Smarty German Documentation Port --> <!-- Smarty German Documentation Port -->
<!-- $Id$ --> <!-- designers.sgml,v 1.7 2003/01/10 15:52:52 dexxter Exp -->
<!-- $Author$ --> <!-- dexxter -->
<!-- $Version$ --> <!-- 1.7 -->
<part id="smarty.for.designers"> <part id="smarty.for.designers">
<title>Smarty f&uuml;r Template Designer</title> <title>Smarty f&uuml;r Template Designer</title>
@@ -61,10 +61,10 @@
{include file="header.tpl"} {include file="header.tpl"}
{if $name eq "Fred"} {if $highlight_name}
Du bist Fred und darfst das hier sehen! Welcome, &lt;font color="{#fontColor#}"&gt;{$name}!&lt;/font&gt;
{else} {else}
Willkommen, &lt;font color="{#fontColor#}"&gt;{$name}!&lt;/font&gt; Welcome, {$name}!
{/if} {/if}
{include file="footer.tpl"}</programlisting> {include file="footer.tpl"}</programlisting>
@@ -112,35 +112,51 @@
</sect1> </sect1>
<sect1 id="language.syntax.quotes"> <sect1 id="language.syntax.quotes">
<title>Variablen in doppelten Anf&uuml;hrungszeichen</title> <title>Variablen mit Doppelten Anf&uuml;hrungszeichen</title>
<para> <para>
Smarty will recognize assigned variables embedded in double quotes so long Smarty erkennt zugewiesene Variablen mit doppelten Anf&uuml;hrungszeichen solange
as the variables contain only numbers, letters, underscores and brackets die Variablen nur Zahlen, Buchstaben, Understriche oder Klammern [] enthalten. Mit allen
[]. With any other characters (period, object reference, etc.) the variable anderen Zeichen wie Punkt, Objekt Referenzen, etc muss die Vairable mit Backticks umschlossen sein.
must be surrounded by backticks.
Smarty erkennt zugewisene Variablen in doppelten Anf&uuml;hrungszeichen solange
der Variablenname nur Zahlen, Buchstaben, Unterstriche oder Klammern [] enthaelt.
Wenn andere Zeichen (punkte, objekt referenzen, etc) verwendet werden, so muss
die Variable mit Backticks versehen werden.
</para> </para>
<example> <example>
<title>Anf&uuml;hrungszeichen Syntax</title> <title>Syntax von eingebetteten Anf&uuml;rungszeichen</title>
<programlisting> <programlisting>
Syntax Beispiele: SYNTAX BEISPIELE:
{func var="test $foo test"} &lt;-- sieht $foo {func var="test $foo test"} &lt;-- sieht $foo
{func var="test $foo_bar test"} &lt;-- sieht $foo_bar {func var="test $foo_bar test"} &lt;-- sieht $foo_bar
{func var="test $foo[0] test"} &lt;-- sieht $foo[0] {func var="test $foo[0] test"} &lt;-- sieht $foo[0]
{func var="test $foo[bar] test"} &lt;-- sieht $foo[bar] {func var="test $foo[bar] test"} &lt;-- sieht $foo[bar]
{func var="test $foo.bar test"} &lt;-- sieht $foo (not $foo.bar) {func var="test $foo.bar test"} &lt;-- sieht $foo (nicht $foo.bar)
{func var="test `$foo.bar` test"} &lt;-- sieht $foo.bar {func var="test `$foo.bar` test"} &lt;-- sieht $foo.bar
Anwendungsbeispiele: PRAKTISCHE BEISPIELE:
{include file="subdir/$tpl_name.tpl"} &lt;-- $tpl_name wird durch den Wert ersetzt {include file="subdir/$tpl_name.tpl"} &lt;-- ersetzt $tpl_name durch wert
{cycle values="one,two,`$smarty.config.myval`"} &lt;-- muss Backticks enthalten</programlisting> {cycle values="one,two,`$smarty.config.myval`"} &lt;-- muss Backticks enthalten</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.math">
<title>Math</title>
<para>
Mathematische Operationen k&ouml;nnen direkt auf Variablen verwendet werden.
</para>
<example>
<title>Mathematik Beispiele</title>
<programlisting>
{$foo+1}
{$foo*$bar}
{* kompliziertere Beispiele *}
{$foo-&gt;bar-$bar[1]*$baz-&gt;foo-&gt;bar()-3*7}
{if ($foo+$bar.test%$baz*134232+10+$b+10)}
{$foo|truncate:"`$fooTruncCount/$barTruncFactor-1`"}
{assign var="foo" value="`$foo+$bar`"}</programlisting>
</example>
</sect1>
</chapter> </chapter>
<chapter id="language.variables"> <chapter id="language.variables">
@@ -246,25 +262,12 @@ email: zaphod@slartibartfast.com&lt;br&gt;</programlisting>
<title>Verwendung von Variablen aus Konfigurationsdateien</title> <title>Verwendung von Variablen aus Konfigurationsdateien</title>
<para> <para>
Variablen, die aus einer Konfigurationsdatei geladen werden, referenziert man mit Variablen, die aus einer Konfigurationsdatei geladen werden, referenziert man mit
umschliessenden '#'-Zeichen (Raute), oder der Smarty Variable <link linkend="language.variables.smarty.config">$smarty.config</link>. umschliessenden '#'-Zeichen (Raute).
Die zweite Syntax ist sinnvoll, wenn Werte in Variablen mit Anf<6E>hrungszeichen geladen werden sollen.
</para> </para>
<example> <example>
<title>Konfigurationsvariablen</title> <title>Konfigurationsvariablen</title>
<programlisting> <programlisting>
foo.conf:
seitenTitel = "This is mine"
bodyHintergrundFarbe = "#eeeeee"
tabelleRahmenBreite = "3"
tabelleHintergrundFarbe = "#bbbbbb"
reiheHintergrundFarbe = "#cccccc"
index.tpl:
{config_load file="foo.conf"}
&lt;html&gt; &lt;html&gt;
&lt;title&gt;{#seitenTitel#}&lt;/title&gt; &lt;title&gt;{#seitenTitel#}&lt;/title&gt;
&lt;body bgcolor="{#bodyHintergrundFarbe#}"&gt; &lt;body bgcolor="{#bodyHintergrundFarbe#}"&gt;
@@ -276,42 +279,7 @@ index.tpl:
&lt;/tr&gt; &lt;/tr&gt;
&lt;/table&gt; &lt;/table&gt;
&lt;/body&gt; &lt;/body&gt;
&lt;/html&gt; &lt;/html&gt;</programlisting>
AUSGABE:
&lt;html&gt;
&lt;title&gt;This is mine&lt;/title&gt;
&lt;body bgcolor="#eeeeee"&gt;
&lt;table border="3" bgcolor="#bbbbbb"&gt;
&lt;tr bgcolor="#cccccc"&gt;
&lt;td&gt;Vornamen&lt;/td&gt;
&lt;td&gt;Nachnamen&lt;/td&gt;
&lt;td&gt;Adresse&lt;/td&gt;
&lt;/tr&gt;
&lt;/table&gt;
&lt;/body&gt;
&lt;/html&gt;
index.tpl: (alternate syntax)
{config_load file="foo.conf"}
&lt;html&gt;
&lt;title&gt;{$smarty.config.seitenTitel}&lt;/title&gt;
&lt;body bgcolor="{$smarty.config.bodyHintergrundFarbe}"&gt;
&lt;table border="{$smarty.config.tabelleRahmenBreite}" bgcolor="{$smarty.config.tabelleHintergrundFarbe}"&gt;
&lt;tr bgcolor="{$smarty.config.reiheHintergrundFarbe}"&gt;
&lt;td&gt;Vornamen&lt;/td&gt;
&lt;td&gt;Nachnamen&lt;/td&gt;
&lt;td&gt;Adresse&lt;/td&gt;
&lt;/tr&gt;
&lt;/table&gt;
&lt;/body&gt;
&lt;/html&gt;
AUSGABE: (gleich, f&uuml;r beide Beispiele)
</programlisting>
</example> </example>
<para> <para>
Variablen aus Konfigurationsdateien k&ouml;nnen erst verwendet werden, Variablen aus Konfigurationsdateien k&ouml;nnen erst verwendet werden,
@@ -387,16 +355,6 @@ AUSGABE: (gleich, f&uuml;r beide Beispiele)
</para> </para>
</sect2> </sect2>
<sect2 id="language.variables.smarty.config">
<title>{$smarty.config}</title>
<para>
{$smarty} kann verwendet werden um auf geladenen Konfigurationsdateien zu referenzieren.
{$smarty.config.foo} ist ein Synonym f&uuml;r {#foo#}. Konsultieren Sie den Abschnitt
<link linkend="language.function.config.load">config_load</link> f&uuml;r ein Beispiel.
</para>
</sect2>
<sect2 id="language.variables.smarty.loops"> <sect2 id="language.variables.smarty.loops">
<title>{$smarty.section}, {$smarty.foreach}</title> <title>{$smarty.section}, {$smarty.foreach}</title>
<para> <para>
@@ -441,7 +399,18 @@ Thema: {$thema|truncate:40:"..."}</programlisting>
Modifikator ein <literal>@</literal> Zeichen vorangestellt werden. Beispiel: Modifikator ein <literal>@</literal> Zeichen vorangestellt werden. Beispiel:
<literal>{$artikelTitel|@count}</literal> (gibt die Anzahl Elemente des Arrays $artikelTitel aus.) <literal>{$artikelTitel|@count}</literal> (gibt die Anzahl Elemente des Arrays $artikelTitel aus.)
</para> </para>
<para>
Modifikatoren k&ouml;nnen aus Ihrem <link linkend="variable.plugins.dir">$plugins_dir</link>
automatisch geladen (sehen Sie dazu auch <link linkend="plugins.naming.conventions">Naming Conventions</link>)
oder explizit registriert werden (<link linkend="api.register.modifier">register_modifier</link>).
Zudem k&ouml;nnen alle PHP-Funktionen implizit als Modifikatoren verwendet werden. (Das Beispiel mit dem
<literal>@count</literal> Modifier verwendet die Funktion 'count' von PHP und keinen Smarty Modifikator)
PHP Funktionen zu verwenden er&ouml;ffnet zwei Probleme: erstens: manchmal ist die Parameter Reiehnfolge nicht
erw&uuml;nscht. (<literal>{"%2.f"|sprintf:$float}</literal> funktioniert zwar, sieht aber als <literal>{$float|string_format:"%2.f"}</literal>
das durch Smarty geliefert wird, besser aus. Zweitens: wenn <link linkend="variable.security">$security</link> auf TRUE gesetzt ist,
m&uuml;ssen alle verwendeten PHP Funktionen im <link linkend="variable.security.settings">$security_settings['MODIFIER_FUNCS']</link>-Array
enthalten sein.
</para>
<sect1 id="language.modifier.capitalize"> <sect1 id="language.modifier.capitalize">
<title>capitalize (in Grossbuchstaben schreiben)</title> <title>capitalize (in Grossbuchstaben schreiben)</title>
<para> <para>
@@ -461,6 +430,33 @@ Diebe Haben In Norwegen 20 Tonnen Streusalz Entwendet.</programlisting>
</sect1> </sect1>
<sect1 id="language.modifier.count.characters"> <sect1 id="language.modifier.count.characters">
<title>count_characters (Buchstaben z&auml;hlen)</title> <title>count_characters (Buchstaben z&auml;hlen)</title>
<informaltable frame=all>
<tgroup cols=6>
<colspec colname=param align=center>
<colspec colname=type align=center>
<colspec colname=required align=center>
<colspec colname=default align=center>
<colspec colname=desc>
<thead>
<row>
<entry>Parameter Position</entry>
<entry>Typ</entry>
<entry>Ben&ouml;tigt</entry>
<entry>Standard</entry>
<entry>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
<entry>1</entry>
<entry>boolean</entry>
<entry>Nein</entry>
<entry>false</entry>
<entry>Definiert ob Leerzeichen mitgez&auml;hlt werden sollen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para> <para>
Wird verwendet um die Anzahl Buchstaben in einer Variable auszugeben. Wird verwendet um die Anzahl Buchstaben in einer Variable auszugeben.
</para> </para>
@@ -470,64 +466,15 @@ Diebe Haben In Norwegen 20 Tonnen Streusalz Entwendet.</programlisting>
{$artikelTitel} {$artikelTitel}
{$artikelTitel|count_characters} {$artikelTitel|count_characters}
{$artikelTitel|count_characters:true}
AUSGABE: AUSGABE:
20% der US-Amerikaner finden ihr Land (die USA) nicht auf der Landkarte. 20% der US-Amerikaner finden ihr Land (die USA) nicht auf der Landkarte.
72</programlisting> 72
61</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.modifier.cat">
<title>cat</title>
<informaltable frame=all>
<tgroup cols=5>
<colspec colname=param align=center>
<colspec colname=type align=center>
<colspec colname=required align=center>
<colspec colname=cat align=center>
<colspec colname=desc>
<thead>
<row>
<entry>Parameter Position</entry>
<entry>Typ</entry>
<entry>Erforderlich</entry>
<entry>cat</entry>
<entry>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
<entry>1</entry>
<entry>string</entry>
<entry>Nein</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>H&auml;ngt den &uuml;bergebenen Wert der Variable an.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Dieser Wert wird der Variable angeh&auml;ngt.
</para>
<example>
<title>cat</title>
<programlisting>
index.php:
$smarty = new Smarty;
$smarty-&gt;assign('articleTitle', 'Psychics predict world didn't end');
$smarty-&gt;display('index.tpl');
index.tpl:
{$articleTitle|cat:" yesterday."}
AUSGABE:
Psychics predict world didn't end yesterday.</programlisting>
</example>
</sect1>
<sect1 id="language.modifier.count.paragraphs"> <sect1 id="language.modifier.count.paragraphs">
<title>count_paragraphs (Abs&auml;tze z&auml;hlen)</title> <title>count_paragraphs (Abs&auml;tze z&auml;hlen)</title>
<para> <para>
@@ -927,30 +874,6 @@ AUSGABE:
In Kalifornien wurde ein Hund in das W&auml;hlerverzeichnis eingetragen. In Kalifornien wurde ein Hund in das W&auml;hlerverzeichnis eingetragen.
in kalifornien wurde ein hund in das w&auml;hlerverzeichnis eingetragen.</programlisting> in kalifornien wurde ein hund in das w&auml;hlerverzeichnis eingetragen.</programlisting>
</example>
</sect1>
<sect1 id="language.modifier.nl2br">
<title>nl2br</title>
<para>
Konvertiert alle Zeilenschaltungen in der Variable in &lt;br /&gt; Tags.
Verh&auml;lt sich gleich wie die PHP Funktion 'nl2br()'.
</para>
<example>
<title>nl2br</title>
<programlisting>
index.php:
$smarty = new Smarty;
$smarty-&gt;assign('articleTitle', "Sun or rain expected\ntoday, dark tonight");
$smarty-&gt;display('index.tpl');
index.tpl:
{$articleTitle|nl2br}
AUSGABE:
Sun or rain expected&lt;br /&gt;today, dark tonight</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.modifier.regex.replace"> <sect1 id="language.modifier.regex.replace">
@@ -1423,6 +1346,40 @@ e i n e m s t a d t r. . .</programlisting>
</para> </para>
<sect1 id="language.function.capture"> <sect1 id="language.function.capture">
<title>capture (Ausgabe abfangen)</title> <title>capture (Ausgabe abfangen)</title>
<informaltable frame=all>
<tgroup cols=5>
<colspec colname=param align=center>
<colspec colname=type align=center>
<colspec colname=required align=center>
<colspec colname=default align=center>
<colspec colname=desc>
<thead>
<row>
<entry>Attribut Name</entry>
<entry>Typ</entry>
<entry>Ben&ouml;tigt</entry>
<entry>Standardwert</entry>
<entry>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>no</entry>
<entry><emphasis>default</emphasis></entry>
<entry>Der Name des abgefangenen Blocks</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>No</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Der Name der Variable welcher der Wert zugewiesen werden soll.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para> <para>
'capture' wird verwendet, um die Template-Ausgabe abzufangen und in einer 'capture' wird verwendet, um die Template-Ausgabe abzufangen und in einer
Variable zu speichern. Der Inhalt zwischen {capture name="foo"} und {/capture} Variable zu speichern. Der Inhalt zwischen {capture name="foo"} und {/capture}
@@ -1690,6 +1647,51 @@ phone: 555-4444&lt;br&gt;
fax: 555-3333&lt;br&gt; fax: 555-3333&lt;br&gt;
cell: 760-1234&lt;br&gt;</programlisting> cell: 760-1234&lt;br&gt;</programlisting>
</example> </example>
<para>
Foreach-Loops haben auch eigene Variablen welche die Foreach Eigenschaften enthalten.
Diese werden wie folgt ausgewiesen: {$smarty.foreach.foreachname.varname}. foreachname
ist der Name der als <emphasis>name</emphasis> Attribut von Foreach &uuml;bergeben wurden.
</para>
<sect2 id="foreach.property.iteration">
<title>iteration</title>
<para>
gibt die aktuelle iteration aus
</para>
<para>
iteration beginnt immer mit 1 und wird danach bei jedem durchgang um 1 inkrementiert.
</para>
</sect2>
<sect2 id="foreach.property.first">
<title>first</title>
<para>
<emphasis>first</emphasis> ist TRUE wenn die aktuelle Iteration die erste ist
</para>
</sect2>
<sect2 id="foreach.property.last">
<title>last</title>
<para>
<emphasis>last</emphasis> ist TRUE wenn die aktuelle Iteration die letzte ist
</para>
</sect2>
<sect2 id="foreach.property.show">
<title>show</title>
<para>
<emphasis>show</emphasis> wird als Parameter von foreach verwedet und ist ein boolscher Wert, TRUE oder FALSE. Auf FALSE wird
nichts ausgegeben und wenn foreachelse gefunden wird, dieser angezeigt.
</para>
</sect2>
<sect2 id="foreach.property.total">
<title>total</title>
<para>
<emphasis>total</emphasis> gibt die Anzahl Iterationen des Foreach Loops aus und kann in- oder nach- Foreach Bl&ouml;cken verwendet werden.
</para>
</sect2>
</sect1> </sect1>
<sect1 id="language.function.include"> <sect1 id="language.function.include">
<title>include (einbinden)</title> <title>include (einbinden)</title>
@@ -3014,23 +3016,16 @@ AUSGABE:
<programlisting> <programlisting>
{* initialisieren *} {* initialisieren *}
{section name=rows loop=$data} {cycle values="#eeeeee,#d0d0d0"}
&lt;tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"&gt; {cycle}
&lt;td&gt;{$data[rows]}&lt;/td&gt; {cycle}
&lt;/tr&gt;
{/section}
AUSGABE: AUSGABE:
&lt;tr bgcolor="#eeeeee"&gt;
&lt;td&gt;1&lt;/td&gt; #eeeeee
&lt;/tr&gt; #d0d0d0
&lt;tr bgcolor="#d0d0d0"&gt; #eeeeee</programlisting>
&lt;td&gt;2&lt;/td&gt;
&lt;/tr&gt;
&lt;tr bgcolor="#eeeeee"&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;/tr&gt;
</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.function.debug"> <sect1 id="language.function.debug">
@@ -3273,55 +3268,60 @@ Bitte geben Sie einen &lt;b&gt;Provinznamen&lt;/b&gt; ein.
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>Nein</entry>
<entry><emphasis>checkbox</emphasis></entry> <entry><emphasis>checkbox</emphasis></entry>
<entry>Name der checkbox-Liste</entry> <entry>Name der checkbox Liste</entry>
</row> </row>
<row> <row>
<entry>werte</entry> <entry>values</entry>
<entry>array</entry> <entry>array</entry>
<entry>Ja, ausser wenn das option-Attribut verwendet wird</entry> <entry>ja, ausser wenn das option Attribut verwendet wird</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Ein Array mit Werten f&uuml;r die checkbox-Liste</entry> <entry>ein Array mit Werten f&uuml;r die checkboxes</entry>
</row> </row>
<row> <row>
<entry>ausgabe</entry> <entry>output</entry>
<entry>array</entry> <entry>array</entry>
<entry>Ja, ausser wenn das option-Attribut verwendet wird</entry> <entry>ja, ausser wenn das option Attribut verwendet wird</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Ein Array mit Ausgaben/Namen f&uuml;r die checkbox-Liste</entry> <entry>ein Array mit Werten f&uuml;r checkbox Kn&ouml;pfe</entry>
</row> </row>
<row> <row>
<entry>checked</entry> <entry>selected</entry>
<entry>string</entry> <entry>string/array</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>empty</emphasis></entry> <entry><emphasis>empty</emphasis></entry>
<entry>Das ausgew&auml;hlte option-Element</entry> <entry>das/die ausgew&auml;hlten checkbox Elemente</entry>
</row> </row>
<row> <row>
<entry>options</entry> <entry>options</entry>
<entry>associative array</entry> <entry>assoziatives array</entry>
<entry>Ja, ausser wert/ausgabe wird verwendet</entry> <entry>Ja, ausser Werte/Ausgabe wird verwendet</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Assoziatives Array mit Wert/Ausgabe Paaren</entry> <entry>ein assoziatives Array mit Werten und Ausgaben</entry>
</row> </row>
<row> <row>
<entry>separator</entry> <entry>separator</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>empty</emphasis></entry> <entry><emphasis>empty</emphasis></entry>
<entry>Zeichenkette die zwischen den checkboxes ausgegeben werden soll</entry> <entry>Zeichenkette die zwischen den checkbox Elementen eingef&uuml;gt werden soll</entry>
</row>
<row>
<entry>labels</entry>
<entry>boolean</entry>
<entry>No</entry>
<entry><emphasis>true</emphasis></entry>
<entry>f&uuml;gt der Ausgabe &lt;label&gt;-Tags hinzu</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<para> <para>
html_checkboxes generiert HTML-Checkboxes mit den &Uuml;bergebenen Werten. html_checkboxes ist eine Funktion die aus den &uuml;bergebenen Daten html checkbox
K&uuml;mmert sich auch darum welches option-Element ausgew&auml;hlt sein soll. Elemente erstellt und k&uuml;mmert sich darum welche Elemente ausgew&auml;hlt sind.
Erforderliche Attribute sind Werte/Ausgabe ausser wenn options verwendet wird. Erforderliche Attribute sind Wert/Ausgabe oder Options. Die Ausgabe ist XHTML kompatibel
Die Ausgabe ist XHTML kompatibel.
</para> </para>
<para> <para>
Alle weiteren Parameter, die in der obigen Liste nicht erw&auml;hnt werden, Alle Parameter die nicht in der Liste erw&auml;hnt werden, werden ausgegeben.
werden als &lt;input&gt;-Tags ausgegeben.
</para> </para>
<example> <example>
<title>html_checkboxes</title> <title>html_checkboxes</title>
@@ -3331,8 +3331,7 @@ index.php:
require('Smarty.php.class'); require('Smarty.php.class');
$smarty = new Smarty; $smarty = new Smarty;
$smarty-&gt;assign('cust_ids', array(1000,1001,1002,1003)); $smarty-&gt;assign('cust_ids', array(1000,1001,1002,1003));
$smarty-&gt;assign('cust_names', array('Joe Schmoe','Jack Smith','Jane $smarty-&gt;assign('cust_names', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown'));
Johnson','CHarlie Brown'));
$smarty-&gt;assign('customer_id', 1001); $smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl'); $smarty-&gt;display('index.tpl');
@@ -3347,9 +3346,10 @@ index.php:
require('Smarty.php.class'); require('Smarty.php.class');
$smarty = new Smarty; $smarty = new Smarty;
$smarty-&gt;assign('cust_checkboxes', array( $smarty-&gt;assign('cust_checkboxes', array(
1001 =&gt; 'Joe Schmoe', 1000 =&gt; 'Joe Schmoe',
1002 =&gt; 'Jack Smith', 1001 =&gt; 'Jack Smith',
1003 =&gt; 'Jane Johnson','Carlie Brown')); 1002 =&gt; 'Jane Johnson',
1003 =&gt; 'Charlie Brown'));
$smarty-&gt;assign('customer_id', 1001); $smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl'); $smarty-&gt;display('index.tpl');
@@ -3358,12 +3358,12 @@ index.php:
{html_checkboxes name="id" options=$cust_checkboxes checked=$customer_id separator="&lt;br /&gt;"} {html_checkboxes name="id" options=$cust_checkboxes checked=$customer_id separator="&lt;br /&gt;"}
AUSGABE: (Beide Beispiele) AUSGABE: (beider Beispiele)
&lt;input type="checkbox" name="id[]" value="1000"&gt;Joe Schmoe&lt;br /&gt; &lt;label&gt;&lt;input type="checkbox" name="checkbox[]" value="1000" /&gt;Joe Schmoe&lt;/label&gt;&lt;br /&gt;
&lt;input type="checkbox" name="id[]" value="1001" checked="checked"&gt;&lt;br /&gt; &lt;label&gt;&lt;input type="checkbox" name="checkbox[]" value="1001" checked="checked" /&gt;Jack Smith&lt;/label&gt;&lt;br /&gt;
&lt;input type="checkbox" name="id[]" value="1002"&gt;Jane Johnson&lt;br /&gt; &lt;label&gt;&lt;input type="checkbox" name="checkbox[]" value="1002" /&gt;Jane Johnson&lt;/label&gt;&lt;br /&gt;
&lt;input type="checkbox" name="id[]" value="1003"&gt;Charlie Brown&lt;br /&gt;</programlisting> &lt;label&gt;&lt;input type="checkbox" name="checkbox[]" value="1003" /&gt;Charlie Brown&lt;/label&gt;&lt;br /&gt;</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.function.html.image"> <sect1 id="language.function.html.image">
@@ -3397,59 +3397,65 @@ index.php:
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>Nein</entry>
<entry><emphasis>0</emphasis></entry> <entry><emphasis>0</emphasis></entry>
<entry>Gr&ouml;sse des Rahmens</entry> <entry>St&auml;rke des Rahmens</entry>
</row> </row>
<row> <row>
<entry>height</entry> <entry>height</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>Bildh&ouml;he</emphasis></entry> <entry><emphasis>Normale H&ouml;he des Bildes</emphasis></entry>
<entry>Darstellungsh&ouml;he</entry> <entry>H&ouml;he des Bildes</entry>
</row> </row>
<row> <row>
<entry>width</entry> <entry>width</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>Bildbreite</emphasis></entry> <entry><emphasis>Normale Breite des Bildes</emphasis></entry>
<entry>Darstellungsbreite</entry> <entry>Breite des Bildes</entry>
</row> </row>
<row> <row>
<entry>basedir</entry> <entry>basedir</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>no</entry>
<entry><emphasis>DocumentRoot des Webservers</emphasis></entry> <entry><emphasis>web server doc root</emphasis></entry>
<entry>Verzeichnis auf das relative Pfade aufgebaut werden sollen</entry> <entry>directory to base relative paths from</entry>
</row> </row>
<row> <row>
<entry>link</entry> <entry>alt</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>no</entry>
<entry><emphasis>""</emphasis></entry>
<entry>Alternative Beschreibung des Bildes</entry>
</row>
<row>
<entry>href</entry>
<entry>string</entry>
<entry>no</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>href-Ziel auf das das Bild verweisen soll</entry> <entry>href Wert des Tags</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<para> <para>
'html_image' generiert ein HTML-Tag f&uml;r ein Bild. H&ouml;he und Breite html_image ist eine eigene Funktion die ein HTML Tag f&uuml;r ein Bild erzeugt.
werden berechnet falls sie nicht &uml;bergeben werden. Die H&ouml;he und Breite der Ausgabe wird automatisch aus der Bilddatei berechnet
wenn die Werte nicht &uuml;bergeben werden.
</para> </para>
<para> <para>
'basedir' definiert das Verzeichnis auf welchen relative Pfade aufgebaut basedir ist der Basispfad der f&uuml;r die Verlinkung verwendet werden soll. Wenn kein
werden sollen. Falls nicht &uml;bergeben, wird die Umgebungsvariable Wert &uuml;bergeben wird, wird die Umgebungsvariable DOCUMENT_ROOT verwendet. Wenn Sicherheit
DOCUMENT_ROOT verwendet. Wenn Sicherheit eingeschaltet ist, muss der eingeschaltet ist, muss das Bild in einem sicheren Verzeichnis liegen.
Pfad in einem sicheren Verzeichnis sein.
</para> </para>
<para> <para>
Wenn 'link' &uuml;bergeben wird, wird um das Bild ein &lt;a href="LINKVALUE"&gt;&lt;a&gt; <parameter>href</parameter> ist das href Attribut f&uuml;r das Image-Tag. Wenn dieser Wert &uuml;bergeben wird,
Tag eingef&uuml;hgt. wird um das Bild ein &lt;a href="LINKVALUE"&gt;&lt;a&gt; Tag erzeugt.
</para> </para>
<note> <note>
<title>Technische Bemerkung</title> <title>Technische Bemerkung</title>
<para> <para>
'html_image' verursacht Festplattenzugriffe um die Breite/H&ouml;he des Bildes html_image greift auf das Dateisystem zu um H&ouml;he und Breite zu errechnen. Wenn Sie
zu berechnen. Falls Sie kein 'caching' einsetzen, ist es zu empfehlen, 'html_image' caching nicht verwenden sollten Sie normalerweise auf diese Funktion aus performance Gr&uuml;nden verzichten.
nicht zu verwenden, und stattdessen statische image Tags zu verwenden.
</para> </para>
</note> </note>
<example> <example>
@@ -3463,15 +3469,19 @@ index.php:
index.tpl: index.tpl:
{image file="pumpkin.jpg"} {html_image file="pumpkin.jpg"}
{image file="/pfad/aus/docroot/pumpkin.jpg"} {html_image file="/path/from/docroot/pumpkin.jpg"}
{image file="../pfad/relativ/zu/aktuellem/verzeichnis/pumpkin.jpg"} {html_image file="../path/relative/to/currdir/pumpkin.jpg"}
AUSGABE: (m&ouml;glich) AUSGABE: (m&ouml;glich)
&lt;img src="pumpkin.jpg" border="0" width="44" height="68"&gt; &lt;img src="pumpkin.jpg" alt="" border="0" width="44" height="68" /&gt;
&lt;img src="/pfad/aus/docroot/pumpkin.jpg" border="0" width="44" height="68"&gt; &lt;img src="/path/from/docroot/pumpkin.jpg" alt="" border="0" width="44" height="68" /&gt;
&lt;img src="../pfad/relativ/zu/aktuellem/verzeichnis/pumpkin.jpg" border="0" width="44" height="68"&gt;</programlisting> &lt;img src="../path/relative/to/currdir/pumpkin.jpg" alt="" border="0" width="44" height="68" /&gt;</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.function.html.options"> <sect1 id="language.function.html.options">
@@ -3512,7 +3522,7 @@ index.php:
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>Nein</entry>
<entry><emphasis>empty</emphasis></entry> <entry><emphasis>empty</emphasis></entry>
<entry>Das ausgew&auml;hlte Option Element.</entry> <entry>Das ausgew&auml;hlte Array Element.</entry>
</row> </row>
<row> <row>
<entry>options</entry> <entry>options</entry>
@@ -3521,13 +3531,6 @@ index.php:
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Assoziatives Array mit Werten die ausgegeben werden sollen.</entry> <entry>Assoziatives Array mit Werten die ausgegeben werden sollen.</entry>
</row> </row>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Nein</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>Name der select-Gruppe</entry>
</row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
@@ -3535,76 +3538,41 @@ index.php:
'html_options' wird verwendet um HTML-Options Listen mit den &uuml;bergebenen Daten 'html_options' wird verwendet um HTML-Options Listen mit den &uuml;bergebenen Daten
zu erzeugen. Die Funktion k&uuml;mmert sich ebenfalls um das setzen des ausgew&auml;hlten zu erzeugen. Die Funktion k&uuml;mmert sich ebenfalls um das setzen des ausgew&auml;hlten
Standardwertes. Die Attribute 'values' und 'output' sind erforderlich, Standardwertes. Die Attribute 'values' und 'output' sind erforderlich,
ausser man verwendet das Attribut 'options'. ausser man verwendet das Attribut 'options'. Wenn ein Wert als Array erkannt wird,
</para>
<para>
Wenn ein Wert als Array erkannt wird,
wird er als HTML-OPTGROUP ausgegeben und die Werte werden in Gruppen dargestellt. wird er als HTML-OPTGROUP ausgegeben und die Werte werden in Gruppen dargestellt.
Rekursion wird unterst&uuml;tzt. Die Ausgabe ist XHTML kompatibel. Rekursion wird unterst&uuml;tzt. Die Ausgabe ist XHTML kompatibel.
</para> </para>
<para>
Wenn das optionale <emphasis>name</emphasis> Attribut &uuml;bergeben wird,
umschliesst ein &lt;select name="groupname"&gt;&lt;/select&gt; Tag die 'options'-Liste.
Sonst wird nur die 'options'-Liste generiert.
</para>
<para>
All parameters that are not in the list above are printed as
name/value-pairs inside the &lt;select&gt;-tag. They are ignored if
the optional <emphasis>name</emphasis> is not given.
Alle weiteren Parameter werden innerhalb des &lt;select&gt;-Tags
als wert/ausgabe-Paare &uuml;bergeben. Falls <emphasis>name</emphasis>
nicht &uuml;bergeben wird, werden die Werte ignoriert.
</para>
<example> <example>
<title>html_options</title> <title>html_options</title>
<programlisting> <programlisting>
index.php: {* nehmen Sie an, dass $cust_ids und $cust_names Arrays mit Werten sind,
w&auml;hrend $customer_id auch leer sein kann *}
require('Smarty.php.class');
$smarty = new Smarty;
$smarty-&gt;assign('cust_ids', array(1000,1001,1002,1003));
$smarty-&gt;assign('cust_names', array('Joe Schmoe','Jack Smith','Jane
Johnson','Carlie Brown'));
$smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl');
index.tpl:
&lt;select name=customer_id&gt; &lt;select name=customer_id&gt;
{html_options values=$cust_ids selected=$customer_id output=$cust_names} {html_options values=$cust_ids selected=$customer_id output=$cust_names}
&lt;/select&gt; &lt;/select&gt;
index.php:
require('Smarty.php.class'); {* alternativ k&ouml;nnen die Werte aus 'values' und 'output' als assoziative Arrays
$smarty = new Smarty; an 'options' &uuml;bergeben werden. $customer_options ist in diesem Beispiel ein assoziatives Array *}
$smarty-&gt;assign('cust_options', array(
1001 =&gt; 'Joe Schmoe',
1002 =&gt; 'Jack Smith',
1003 =&gt; 'Jane Johnson',
1004 =&gt; 'Charlie Brown'));
$smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl');
index.tpl:
&lt;select name=customer_id&gt; &lt;select name=customer_id&gt;
{html_options options=$cust_options selected=$customer_id} {html_options options=$customer_options selected=$customer_id}
&lt;/select&gt; &lt;/select&gt;
AUSGABE (beide Beispiele): AUSGABE:
&lt;select name=customer_id&gt; &lt;select name=customer_id&gt;
&lt;option value="1000"&gt;Joe Schmoe&lt;/option&gt; &lt;option value="1000">Joe Schmoe&lt;/option&gt;
&lt;option value="1001" selected="selected"&gt;Jack Smith&lt;/option&gt; &lt;option value="1001" selected="selected">Jack Smith&lt;/option&gt;
&lt;option value="1002"&gt;Jane Johnson&lt;/option&gt; &lt;option value="1002">Jane Johnson&lt;/option&gt;
&lt;option value="1003"&gt;Charlie Brown&lt;/option&gt; &lt;option value="1003">Charlie Brown&lt;/option&gt;
&lt;/select&gt;</programlisting> &lt;/select&gt;</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.function.html.radios"> <sect1 id="language.function.html.radios">
<title>html_radios</title> <title>html_radios (Ausgabe von HTML-Radio Tags)</title>
<informaltable frame=all> <informaltable frame=all>
<tgroup cols=5> <tgroup cols=5>
<colspec colname=param align=center> <colspec colname=param align=center>
@@ -3627,53 +3595,50 @@ AUSGABE (beide Beispiele):
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>Nein</entry>
<entry><emphasis>radio</emphasis></entry> <entry><emphasis>radio</emphasis></entry>
<entry>name der radio-Liste</entry> <entry>Name der Radio Liste</entry>
</row> </row>
<row> <row>
<entry>values</entry> <entry>values</entry>
<entry>array</entry> <entry>array</entry>
<entry>Ja, ausser wenn das 'options'-Attribut verwendet wird</entry> <entry>Ja, ausser 'options'-Attribut wird verwendet.</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Ein Array mit Werten f&uuml;r die radio-Liste</entry> <entry>Array mit Werten f&uuml;r die dropdown-Liste.</entry>
</row> </row>
<row> <row>
<entry>output</entry> <entry>output</entry>
<entry>array</entry> <entry>array</entry>
<entry>Ja, ausser wenn das 'options'-Attribut verwendet wird</entry> <entry>Ja, ausser 'options'-Attribut wird verwendet.</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Ein Array mit Namen f&uuml;r die radio-Liste</entry> <entry>Arrays mit Namen f&uuml;r die dropdown-Liste.</entry>
</row> </row>
<row> <row>
<entry>checked</entry> <entry>selected</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>Nein</entry>
<entry><emphasis>empty</emphasis></entry> <entry><emphasis>empty</emphasis></entry>
<entry>Das ausgew&auml;hlte checkbox-Element</entry> <entry>Das ausgew&auml;hlte Array Element.</entry>
</row> </row>
<row> <row>
<entry>options</entry> <entry>options</entry>
<entry>associative array</entry> <entry>associative array</entry>
<entry>Ja, ausser wenn die Attribute 'values' und 'output' verwendet werden</entry> <entry>Ja, ausser wenn das 'values'- und das 'output'-Attribut verwendet werden.</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Ein assoziatves Array mit wert/ausgabe Paaren</entry> <entry>Assoziatives Array mit Werten die ausgegeben werden sollen.</entry>
</row> </row>
<row> <row>
<entry>separator</entry> <entry>separator</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>empty</emphasis></entry> <entry><emphasis>empty</emphasis></entry>
<entry>Zeichenkette die zwischen den radio-Elementen eingef&uuml;gt werden soll.</entry> <entry>Die Zeichenkette die zwischen 2 Radioelemente eingef&uuml;gt werden soll.</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<para> <para>
'html_radios' generiert eine Liste mit radio-Elementen aus den &uuml;bergebenen Daten. html_radio ist eine Funktion die aus den &uuml;bergebenen Daten html radio
Es k&uuml;mmert sich ebenfalls darum, welches Element ausgew&auml;hlt sein soll. Erforderliche Elemente erstellt und k&uuml;mmert sich darum welche Elemente ausgew&auml;hlt sind.
Attribute sind 'values'/'output', ausser wenn 'options' verwendet wird. Die Ausgabe ist XHTML kompatibel. Erforderliche Attribute sind Wert/Ausgabe oder Options. Die Ausgabe ist XHTML kompatibel
</para>
<para>
Alle weiteren Parameter werden als &lt;input&gt;-Tags ausgegeben.
</para> </para>
<example> <example>
<title>html_radios</title> <title>html_radios</title>
@@ -3683,7 +3648,8 @@ AUSGABE (beide Beispiele):
require('Smarty.php.class'); require('Smarty.php.class');
$smarty = new Smarty; $smarty = new Smarty;
$smarty-&gt;assign('cust_ids', array(1000,1001,1002,1003)); $smarty-&gt;assign('cust_ids', array(1000,1001,1002,1003));
$smarty-&gt;assign('cust_names', array('Joe Schmoe','Jack Smith','Jane Johnson','Carlie Brown')); $smarty-&gt;assign('cust_names', array('Joe Schmoe','Jack Smith','Jane
Johnson','Carlie Brown'));
$smarty-&gt;assign('customer_id', 1001); $smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl'); $smarty-&gt;display('index.tpl');
@@ -3711,7 +3677,7 @@ AUSGABE (beide Beispiele):
{html_radios name="id" options=$cust_radios checked=$customer_id separator="&lt;br /&gt;"} {html_radios name="id" options=$cust_radios checked=$customer_id separator="&lt;br /&gt;"}
AUSGABE: (beide Beispiele) AUSGABE: (beider Beispiele)
&lt;input type="radio" name="id[]" value="1000"&gt;Joe Schmoe&lt;br /&gt; &lt;input type="radio" name="id[]" value="1000"&gt;Joe Schmoe&lt;br /&gt;
&lt;input type="radio" name="id[]" value="1001" checked="checked"&gt;&lt;br /&gt; &lt;input type="radio" name="id[]" value="1001" checked="checked"&gt;&lt;br /&gt;
@@ -3720,7 +3686,6 @@ AUSGABE (beide Beispiele):
</example> </example>
</sect1> </sect1>
<sect1 id="language.function.html.select.date"> <sect1 id="language.function.html.select.date">
<title>html_select_date (Ausgabe von Daten als HTML-'options')</title> <title>html_select_date (Ausgabe von Daten als HTML-'options')</title>
<informaltable frame=all> <informaltable frame=all>
@@ -4308,7 +4273,7 @@ AUSGABE:
<entry>Attribut Name</entry> <entry>Attribut Name</entry>
<entry>Typ</entry> <entry>Typ</entry>
<entry>Erforderlich</entry> <entry>Erforderlich</entry>
<entry>Standardwert</entry> <entry>Standartwert</entry>
<entry>Beschreibung</entry> <entry>Beschreibung</entry>
</row> </row>
</thead> </thead>
@@ -4318,53 +4283,68 @@ AUSGABE:
<entry>array</entry> <entry>array</entry>
<entry>Ja</entry> <entry>Ja</entry>
<entry><emphasis>n/a</emphasis></entry> <entry><emphasis>n/a</emphasis></entry>
<entry>Array mit den Daten durch die gelooped werden soll.</entry> <entry>Array mit den Daten f&uuml;r den Loop</entry>
</row> </row>
<row> <row>
<entry>cols</entry> <entry>cols</entry>
<entry>integer</entry> <entry>integer</entry>
<entry>Nein</entry> <entry>Nein</entry>
<entry><emphasis>3</emphasis></entry> <entry><emphasis>3</emphasis></entry>
<entry>Anzahl Spalten in der Tabelle</entry> <entry>Anzahl Reihen in einer Tabelle</entry>
</row> </row>
<row> <row>
<entry>table_attr</entry> <entry>table_attr</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>border="1"</emphasis></entry> <entry><emphasis>border="1"</emphasis></entry>
<entry>Attribute f&uuml;r table-Tag</entry> <entry>Attribute f&uuml;r das Table-Tag</entry>
</row> </row>
<row> <row>
<entry>tr_attr</entry> <entry>tr_attr</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>empty</emphasis></entry> <entry><emphasis>empty</emphasis></entry>
<entry>Attribute f&uuml;r tr-Tags (Arrays werden durchlaufen)</entry> <entry>Attribute f&uuml;r das tr-Tag (Arrays werden durchlaufen)</entry>
</row> </row>
<row> <row>
<entry>td_attr</entry> <entry>td_attr</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>empty</emphasis></entry> <entry><emphasis>empty</emphasis></entry>
<entry>Attribute f&uuml;r td-Tags (Arrays werden durchlaufen)</entry> <entry>Attribute f&uuml;r das tr-Tag (Arrays werden durchlaufen)</entry>
</row> </row>
<row> <row>
<entry>trailpad</entry> <entry>trailpad</entry>
<entry>string</entry> <entry>string</entry>
<entry>Nein</entry> <entry>No</entry>
<entry><emphasis>&amp;nbsp;</emphasis></entry> <entry><emphasis>&amp;nbsp;</emphasis></entry>
<entry>Werte um leere Zellen auszuf&uuml;llen</entry> <entry>Wert f&uuml;r leere Zellen</entry>
</row>
<row>
<entry>hdir</entry>
<entry>string</entry>
<entry>No</entry>
<entry><emphasis>right</emphasis></entry>
<entry>Richtung in der die Zeilen gerendered werden. M&ouml;gliche Werte: <emphasis>left</emphasis>/<emphasis>right</emphasis></entry>
</row>
<row>
<entry>vdir</entry>
<entry>string</entry>
<entry>No</entry>
<entry><emphasis>down</emphasis></entry>
<entry>Richtung in der die Reihen gerendered werden. M&ouml;gliche Werte: <emphasis>up</emphasis>/<emphasis>down</emphasis></entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<para> <para>
<emphasis>html_table</emphasis> generiert eine Tabelle aus dem <emphasis>html_table</emphasis> ist eine eigene Funktion die einen Array als
&uuml;bergebenen Array. Das <emphasis>cols</emphasis> Attribut Tabelle ausgibt. Das <emphasis>cols</emphasis> Attribut definiert die Menge
definiert die Anzahl Spalten die generiert werden sollen. <emphasis>table_attr</emphasis>, <emphasis>tr_attr</emphasis> von Reihen die ausgegeben werden sollen. <emphasis>table_attr</emphasis>, <emphasis>tr_attr</emphasis>
und <emphasis>td_attr</emphasis> definiert die Werte die den entsprechenden HTML-Tags als Attribute angeh&auml;ngt werden. und <emphasis>td_attr</emphasis> definieren die Attribute f&uuml;r die HTML Tags. Wenn <emphasis>tr_attr</emphasis>
Wenn <emphasis>tr_attr</emphasis> oder <emphasis>td_attr</emphasis> Arrays sind, werden diese durchlaufen. oder <emphasis>td_attr</emphasis> Arrays sind, werden diese durchlaufen. <emphasis>trailpad</emphasis>
<emphasis>trailpad</emphasis> definiert den Wert der in leere Zellen eingef&uuml;gt werden soll. wird in leere Zellen eingef&uuml;gt.
</para> </para>
<example> <example>
<title>html_table</title> <title>html_table</title>
@@ -4380,8 +4360,8 @@ AUSGABE:
index.tpl: index.tpl:
{html_table loop=$data} {html_table loop=$data}
{html_table loop=$data cols=4 table_attrs='border="0"'} {html_table loop=$data cols=4 table_attr='border="0"'}
{html_table loop=$data cols=4 tr_attrs=$tr} {html_table loop=$data cols=4 tr_attr=$tr}
AUSGABE: AUSGABE:
@@ -4400,7 +4380,6 @@ AUSGABE:
&lt;tr bgcolor="#dddddd"&gt;&lt;td&gt;5&lt;/td&gt;&lt;td&gt;6&lt;/td&gt;&lt;td&gt;7&lt;/td&gt;&lt;td&gt;8&lt;/td&gt;&lt;/tr&gt; &lt;tr bgcolor="#dddddd"&gt;&lt;td&gt;5&lt;/td&gt;&lt;td&gt;6&lt;/td&gt;&lt;td&gt;7&lt;/td&gt;&lt;td&gt;8&lt;/td&gt;&lt;/tr&gt;
&lt;tr bgcolor="#eeeeee"&gt;&lt;td&gt;9&lt;/td&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;/tr&gt; &lt;tr bgcolor="#eeeeee"&gt;&lt;td&gt;9&lt;/td&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</programlisting> &lt;/table&gt;</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="language.function.math"> <sect1 id="language.function.math">

162
docs/de/getting-started.sgml
View File

@@ -72,11 +72,36 @@
<sect1 id="installing.smarty.basic"> <sect1 id="installing.smarty.basic">
<title>Basis Installation</title> <title>Basis Installation</title>
<note>
<title>Technische Bemerkung</title>
<para> <para>
Installieren Sie die Smarty Library Dateien aus dem /libs/ Verzeichnis Dieser Leitfaden geht davon aus, dass Sie Ihr Webserver- und PHP-Setup kennen
der Distribution. Diese PHP Dateien sollten NICHT angepasst werden. Sie und mit den Namenskonventionen f&uuml;r Dateien und Verzeichnisse Ihres Betriebssystems
werden zwischen den verschieden Applikationen die Smarty verwenden geteilt. vertraut sind. Im Folgenden wird ein Unix-Dateisystem verwendet, stellen Sie also
Diese Dateien werden bei einem upgrade ersetzt. sicher, dass sie die f&uuml;r Ihr Betriebssystem n&ouml;tigen &Auml;nderungen vornehmen.
</para>
<para>
Das Beispiel geht davon aus, dass '/php/includes' in Ihrem PHP-'include_path'
liegt. Konsultieren Sie das PHP-Manual f&uuml;r weiterf&uuml;hrende Informationen hierzu.
</para>
</note>
<para>
Installieren Sie als erstes die Smarty-Library Dateien. Diese Dateien
sollten von Ihnen NICHT editiert und von allen Applikationen
verwendet werden. Sie werden nur erneuert, wenn Sie eine neue Version von Smarty installieren.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
Wir empfehlen keine &Auml;nderungen an den Smarty-Library Dateien vorzunehmen.
Dies macht ein m&ouml;gliches Upgrade wesentlich einfacher. Sie m&uuml;ssen
diese Dateien auch nicht anpassen, um Smarty zu konfigurieren! Benutzen Sie f<>r
diesen Zwecke eine Instanz der Smarty-Klasse.
</para>
</note>
<para>
Folgende Library Dateien werden mit Smarty geliefert und werden ben&ouml;tigt:
</para> </para>
<example> <example>
<title>Smarty-Library Dateiliste</title> <title>Smarty-Library Dateiliste</title>
@@ -85,86 +110,98 @@ Smarty.class.php
Smarty_Compiler.class.php Smarty_Compiler.class.php
Config_File.class.php Config_File.class.php
debug.tpl debug.tpl
/plugins/*.php (alle Dateien!)</screen> /core/*.php (alle)
/plugins/*.php (alle)</screen>
</screen>
</example> </example>
<para> <para>
Smarty verwendet eine PHP Konstante namens <link linkend="constant.smarty.dir">SMARTY_DIR</link> Sie k&ouml;nnen diese Dateien entweder in Ihrem PHP-'include_path' oder
die den Systempfad zu den Library Dateien enth&auml;lt. Wenn Ihre Applikation keine auch in irgend einem anderen Verzeichnis ablegen, solange die Konstante
Probleme hat die Library Dateien zu finden, m&uuml;ssen Sie diese Konstante nicht zuweisen, <link linkend="constant.smarty.dir">SMARTY_DIR</link> auf den korrekten
und Smarty wird alle ben&ouml;tigten Dateien finden. Falls <emphasis>Smarty.class.php</emphasis> Pfad zeigt. Im Folgenden werden Beispiele f&uuml;r beide F&auml;lle aufgezeigt.
nicht in Ihrem 'include_path' ist und Sie nicht den absoluten Pfad angeben, m&uuml;ssen Sie
SMARTY_DIR manuell zuweisen. SMARTY_DIR <emphasis>must</emphasis> muss mit einem '/'-Zeichen (slash) enden.
</para> </para>
<para> <para>
So erzeugt man eine Instanz der Smarty-Klasse im PHP-Skript: So erzeugt man eine Instanz der Smarty-Klasse im PHP-Skript:
</para> </para>
<example> <example>
<title>Smarty Instanz aus 'include_path' erstellen:</title> <title>Smarty Instanz erstellen:</title>
<screen> <screen>
require('Smarty.class.php'); require('Smarty.class.php');
$smarty = new Smarty;</screen> $smarty = new Smarty;</screen>
</example> </example>
<para> <para>
Versuchen Sie das oben gezeigte Script auszuf&uuml;hren. Wenn Sie einen Fehler erhalten ('<emphasis>Smarty.class.php</emphasis> file could not be found'), Versuchen Sie das Skript auszuf&uuml;hren. Wenn Sie eine Fehlermeldung erhalten dass
m&uuml;ssen Sie wie folgt vorgehen: <emphasis>Smarty.class.php</emphasis> nicht gefunden werden konnte, versuchen Sie folgendes:
</para> </para>
<example> <example>
<title>&Uuml;bergeben Sie den vollen Pfad</title> <title>Absoluter Pfad &uuml;bergeben</title>
<screen> <screen>
require('/usr/local/lib/php/Smarty/Smarty.class.php'); require('/usr/local/lib/php/Smarty/Smarty.class.php');
$smarty = new Smarty;</screen> $smarty = new Smarty;</screen>
</example> </example>
<example> <example>
<title>F&uuml;gen Sie den Library Pfad Ihrem PHP-'include_path' hinzu</title> <title>Library Verzeichnis dem Include-Pfad hinzuf&uuml;gen</title>
<screen> <screen>
// Editieren Sie die php.ini Datei und f&uuml;gen Sie den Library Pfad Ihrem PHP-'include_path' hinzu // editieren Sie php.ini, f&uuml;gen Sie das Smarty
// Danach sollte folgendes funktionieren. // Verzeichnis Ihrem include_path hinzu, und starten Sie den Webserver neu
// Danach sollte folgendes Funktionieren.
require('Smarty.class.php'); require('Smarty.class.php');
$smarty = new Smarty;</screen> $smarty = new Smarty;</screen>
</example> </example>
<example> <example>
<title>Setzen Sie SMARTY_DIR manuell</title> <title>SMARTY_DIR manuell setzen</title>
<screen> <screen>
define('SMARTY_DIR','/usr/local/lib/php/Smarty/'); define('SMARTY_DIR','/usr/local/lib/php/Smarty/');
require(SMARTY_DIR.'Smarty.class.php'); require(SMARTY_DIR.'Smarty.class.php');
$smarty = new Smarty;</screen> $smarty = new Smarty;</screen>
</example> </example>
<para> <para>
Jetzt, wo die Library Dateien an ihrem Platz sind, wird es Jetzt, wo die Library Dateien an ihrem Platz sind, wird es
Zeit, die Smarty Verzeichnisse zu erstellen. Smarty ben&ouml;tigt 4 Verzeichnisse Zeit, die Smarty Verzeichnisse zu erstellen.
welche (normerweise) <emphasis>templates</emphasis>, <emphasis>templates_c</emphasis>, <emphasis>configs</emphasis>
und <emphasis>cache</emphasis> heissen. Jedes kann jedoch &uuml;ber die
Smarty Attribute <emphasis>$template_dir</emphasis>, <emphasis>$compile_dir</emphasis>, <emphasis>$config_dir</emphasis>,
und <emphasis>$cache_dir</emphasis> definiert werden. Es wird empfohlen f&uuml;r jede Applikation die Smarty verwenden
soll eigene Verzeichnisse einzurichten.
</para> </para>
<para> <para>
Stellen Sie sicher dass Sie die DocumentRoot Ihres Webservers kennen. F&uuml;r unser Beispiel werden wir die Smarty Umgebung f&uuml;r eine
In unserem Beispiel verwenden wir "/web/www.mydomain.com/docs/". Alle G&auml;stebuch-Applikation konfigurieren. Wir verwenden den Applikationsnamen
Smarty-Verzeichnisse werden immer nur von Smarty aufgerufen, nie vom Browser nur, um die Verzeichnis-Struktur zu verdeutlichen. Sie k&ouml;nnen die selbe
direkt. Deshalb wird empfohlen diese Verzeichnisse <emphasis>ausserhalb</emphasis> Umgebung f&uuml;r alle Ihre Applikationen verwenden indem Sie 'guestbook'
der DocumentRoot einzurichten. durch dem Namen Ihrer Applikation ersetzen.
</para> </para>
<para> <para>
F&uuml;r unser installations-Beispiel werden wir die Umgebung f&uuml;r eine Stellen Sie sicher, dass Sie die DocumentRoot Ihres Webservers kennen.
G&auml;stebuchapplikation einrichten. Wir verwenden dies nur als Beispiel, In unserem Beispiel lautet sie '/web/www.domain.com/docs/'.
falls Sie ihre eigene Applikationsumgebung einrichten, ersetzen sie '/guestbook/'
einfach durch den Namen Ihrer eigener Applikation. Unsere Dateien werden unter
"/web/www.mydomain.com/smarty/guestbook/" abgelegt.
</para> </para>
<para>
Die Smarty Verzeichnisse werden in den Klassen-Variablen $template_dir,
$compile_dir, $config_dir und $cache_dir definiert. Die Standardwerte sind:
"templates", "templates_c", "configs" und "cache". F&uuml;r unser Beispiel
legen wir alle diese Verzeichnisse unter '/web/www.domain.com/smarty/guestbook/' an.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
Wir empfehlen, diese Verzeichnisse ausserhalb der DocumentRoot anzulegen,
um m&ouml;gliche Direktzugriffe zu verhindern.
</para>
</note>
<para> <para>
In Ihrer DocumentRoot muss mindestens eine Datei liegen, die f&uuml;r Browser In Ihrer DocumentRoot muss mindestens eine Datei liegen, die f&uuml;r Browser
zug&auml;nglich ist. Wir nennen dieses Skript 'index.php', und legen zug&auml;nglich ist. Wir nennen dieses Skript 'index.php', und legen
es in das Verzeichnis '/guestbook/' in unserer DocumentRoot. es in das Verzeichnis '/guestbook/' in unserer DocumentRoot.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
Bequem ist es, den Webserver so zu konfigurieren, dass 'index.php' als Bequem ist es, den Webserver so zu konfigurieren, dass 'index.php' als
Standard-Verzeichnis-Index verwendet wird. Somit kann man das Skript Standard-Verzeichnis-Index verwendet wird. Somit kann man das Skript
direkt mit 'http://www.domain.com/guestbook/' aufrufen. Falls Sie Apache direkt mit 'http://www.domain.com/guestbook/' aufrufen. Falls Sie Apache
@@ -172,6 +209,7 @@ $smarty = new Smarty;</screen>
als letzten Eintrag f&uuml;r DirectoryIndex verwenden. (Jeder Eintrag muss als letzten Eintrag f&uuml;r DirectoryIndex verwenden. (Jeder Eintrag muss
mit einem Leerzeichen abgetrennt werden). mit einem Leerzeichen abgetrennt werden).
</para> </para>
</note>
<para> <para>
Die Dateistruktur bis jetzt: Die Dateistruktur bis jetzt:
@@ -185,6 +223,7 @@ $smarty = new Smarty;</screen>
/usr/local/lib/php/Smarty/Config_File.class.php /usr/local/lib/php/Smarty/Config_File.class.php
/usr/local/lib/php/Smarty/debug.tpl /usr/local/lib/php/Smarty/debug.tpl
/usr/local/lib/php/Smarty/plugins/*.php /usr/local/lib/php/Smarty/plugins/*.php
/usr/local/lib/php/Smarty/core/*.php
/web/www.mydomain.com/smarty/guestbook/templates/ /web/www.mydomain.com/smarty/guestbook/templates/
/web/www.mydomain.com/smarty/guestbook/templates_c/ /web/www.mydomain.com/smarty/guestbook/templates_c/
@@ -194,11 +233,21 @@ $smarty = new Smarty;</screen>
/web/www.mydomain.com/docs/guestbook/index.php</screen> /web/www.mydomain.com/docs/guestbook/index.php</screen>
</example> </example>
<note>
<title>Technische Bemerkung</title>
<para>
Falls Sie kein Caching und keine Konfigurationsdateien verwenden, ist es nicht
erforderlich die Verzeichnisse '$config_dir' und '$cache_dir' zu erstellen.
Es wird jedoch trotzdem empfohlen, da diese Funktionalit&auml;ten eventuell sp&auml;ter
genutzt werden sollen.
</para>
</note>
<para> <para>
Smarty ben&ouml;tigt Schreibzugriff auf die Verzeichnisse '$compile_dir' und '$cache_dir'. Smarty ben&ouml;tigt Schreibzugriff auf die Verzeichnisse '$compile_dir' und '$cache_dir'.
Stellen Sie also sicher, dass der Webserver-Benutzer (normalerweise Benutzer 'nobody' und Gruppe 'nogroup') Stellen Sie also sicher, dass der Webserver-Benutzer (normalerweise Benutzer 'nobody' und Gruppe 'nogroup')
in diese Verzeichnisse schreiben kann. (In OS X lautet der Benutzer normalerweise 'web' und in diese Verzeichnisse schreiben kann. (In OS X lautet der Benutzer normalerweise 'www' und
ist in der Gruppe 'web'). Wenn Sie Apache verwenden, k&ouml;nnen Sie in der httpd.conf (gew<65>hnlich in '/usr/local/apache/conf/') ist in der Gruppe 'www'). Wenn Sie Apache verwenden, k&ouml;nnen Sie in der httpd.conf (gew<65>hnlich in '/usr/local/apache/conf/')
nachsehen, unter welchem Benutzer Ihr Server l&auml;uft. nachsehen, unter welchem Benutzer Ihr Server l&auml;uft.
</para> </para>
@@ -206,11 +255,11 @@ $smarty = new Smarty;</screen>
<title>Dateirechte einrichten</title> <title>Dateirechte einrichten</title>
<screen> <screen>
chown nobody:nobody /web/www.mydomain.com/smarty/templates_c/ chown nobody:nobody /web/www.mydomain.com/smarty/guestbook/templates_c/
chmod 770 /web/www.mydomain.com/smarty/templates_c/ chmod 770 /web/www.mydomain.com/smarty/guestbook/templates_c/
chown nobody:nobody /web/www.mydomain.com/smarty/cache/ chown nobody:nobody /web/www.mydomain.com/smarty/guestbook/cache/
chmod 770 /web/www.mydomain.com/smarty/cache/</screen> chmod 770 /web/www.mydomain.com/smarty/guestbook/cache/</screen>
</example> </example>
<note> <note>
@@ -229,7 +278,7 @@ chmod 770 /web/www.mydomain.com/smarty/cache/</screen>
</para> </para>
<example> <example>
<title>Editieren von /web/www.mydomain.com/smarty/templates/index.tpl</title> <title>Editieren von /web/www.mydomain.com/smarty/guestbook/templates/index.tpl</title>
<screen> <screen>
{* Smarty *} {* Smarty *}
@@ -252,17 +301,14 @@ Hallo, {$name}!</screen>
<para> <para>
Als n&auml;chstes editieren wir die Datei 'index.php'. Wir erzeugen eine Als n&auml;chstes editieren wir die Datei 'index.php'. Wir erzeugen eine
Smarty-Instanz, weisen dem Template eine Variable zu und geben 'index.tpl' aus. Smarty-Instanz, weisen dem Template eine Variable zu und geben 'index.tpl' aus.
In unserem Beispiel ist '/usr/local/lib/php/Smarty' in unserem PHP-'include_path',
stellen Sie sicher dass dies bei Ihrer Installation auch der Fall ist, oder
verwenden Sie ansonsten aboslute Pfade.
</para> </para>
<example> <example>
<title>Editieren von /web/www.mydomain.com/docs/guestbook/index.php</title> <title>Editieren von /web/www.mydomain.com/docs/guestbook/index.php</title>
<screen> <screen>
// Smarty laden define('SMARTY_DIR','/usr/local/lib/php/Smarty/');
require('Smarty.class.php'); require(SMARTY_DIR.'Smarty.class.php');
$smarty = new Smarty; $smarty = new Smarty;
@@ -306,8 +352,7 @@ $smarty->display('index.tpl');</screen>
eine eigene Smarty-Umgebung zu initialisieren. Anstatt immer wieder eine eigene Smarty-Umgebung zu initialisieren. Anstatt immer wieder
die Verzeichnisse zu definieren, kann diese Aufgabe auch in einer einzigen die Verzeichnisse zu definieren, kann diese Aufgabe auch in einer einzigen
Datei erledigt werden. Beginnen wir, indem wir ein neues Verzeichnis namens '/php/includes/guestbook/' Datei erledigt werden. Beginnen wir, indem wir ein neues Verzeichnis namens '/php/includes/guestbook/'
erstellen und eine Datei namens 'setup.php' darin anlegen. In unserem Beispiel ist '/php/includes' erstellen und eine Datei namens 'setup.php' darin anlegen.
im PHP-'include_path'. Stellen Sie sicher dass das auch bei Ihnen der Fall ist, oder benutzen Sie absolute Pfadnamen.
</para> </para>
<example> <example>
@@ -315,9 +360,10 @@ $smarty->display('index.tpl');</screen>
<screen> <screen>
// Smarty Library Dateien laden // Smarty Library Dateien laden
define('SMARTY_DIR','/usr/local/lib/php/Smarty/');
require(SMARTY_DIR.'Smarty.class.php'); require(SMARTY_DIR.'Smarty.class.php');
// steup.php ist auch ein guter Platz um Applikations spezifische Libraries zu laden // ein guter Platz um Applikations spezifische Libraries zu laden
// require('guestbook/guestbook.lib.php'); // require('guestbook/guestbook.lib.php');
class Smarty_GuestBook extends Smarty { class Smarty_GuestBook extends Smarty {
@@ -341,6 +387,18 @@ class Smarty_GuestBook extends Smarty {
}</screen> }</screen>
</example> </example>
<note>
<title>Technische Bemerkung</title>
<para>
In unserem Beispiel werden die Library Dateien ausserhalb der DocumentRoot
abgelegt. Diese Dateien k&ouml;nnten sensitive Informationen enthalten,
die wir nicht zug&auml;nglich machen m&ouml;chten.
Deshalb legen wir alle Library Dateien in '/php/includes/guestbook/' ab
und laden sie in unserem 'setup.php' Skript, wie Sie im oben gezeigten
Beispiel sehen k&ouml;nnen.
</para>
</note>
<para> <para>
Nun passen wir 'index.php' an, um 'setup.php' zu verwenden: Nun passen wir 'index.php' an, um 'setup.php' zu verwenden:
</para> </para>

2
docs/de/manual.sgml
View File

@@ -30,7 +30,7 @@
</author> </author>
</authorgroup> </authorgroup>
<edition>Version 2.5</edition> <edition>Version 2.0</edition>
<copyright> <copyright>
<year>2001</year> <year>2001</year>
<year>2002</year> <year>2002</year>

460
docs/de/programmers.sgml
View File

@@ -390,6 +390,20 @@
Normalerweise '}'. Normalerweise '}'.
</para> </para>
</sect1> </sect1>
<sect1 id="variable.show.info.header">
<title>$show_info_header</title>
<para>
Gibt am Anfang der HTML-Seite die Smarty Version und das Kompilier-Datum des Templates
als Kommentar aus. Normalerweise 'false'.
</para>
</sect1>
<sect1 id="variable.show.info.include">
<title>$show_info_include</title>
<para>
Gibt am Anfang und am Ende jedes eingebundenen Templates einen HTML-Kommentar aus.
Normalerweise 'false'.
</para>
</sect1>
<sect1 id="variable.compiler.class"> <sect1 id="variable.compiler.class">
<title>$compiler_class</title> <title>$compiler_class</title>
<para> <para>
@@ -405,6 +419,16 @@
Verh&auml;lt sich wie 'variables_order' in der php.ini. Verh&auml;lt sich wie 'variables_order' in der php.ini.
</para> </para>
</sect1> </sect1>
<sect1 id="variable.request.use.auto.globals">
<title>$request_use_auto_globals</title>
<para>
Definiert ob Smarty php's $HTTP_*_VARS[] ($request_use_auto_globals=false welches
der Standardwert ist) oder $_*[] ($request_use_auto_globals=true) verwenden soll.
Dies betrifft Templates die {$smarty.request.*}, {$smarty.get.*}, etc... verwenden.
Achtung: wenn $request_use_auto_globals auf TRUE gesetzt ist, hat <link linkend="variable.request.vars.order">variable.request.vars.order </link>
keine Auswirkungen, da php's Konfigurationswert <literal>gpc_order</literal> verwendet wird.
</para>
</sect1>
<sect1 id="variable.compile.id"> <sect1 id="variable.compile.id">
<title>$compile_id</title> <title>$compile_id</title>
<para> <para>
@@ -428,10 +452,20 @@
Definiert ein Array von Variablen-Modifikatoren, die auf jeder Variable anzuwenden sind. Definiert ein Array von Variablen-Modifikatoren, die auf jeder Variable anzuwenden sind.
Wenn Sie zum Beispiel alle Variablen standardm&auml;ssig HTML-Maskieren wollen, Wenn Sie zum Beispiel alle Variablen standardm&auml;ssig HTML-Maskieren wollen,
k&ouml;nnen Sie array('escape:"htmlall"'); verwenden. Um eine Variable von dieser k&ouml;nnen Sie array('escape:"htmlall"'); verwenden. Um eine Variable von dieser
Behandlung auszuschliessen, k&ouml;nnen Sie ihr den Modifikator 'nodefaults' &uuml;bergeben. Behandlung auszuschliessen, k&ouml;nnen Sie ihr den Parameter 'smarty' mit dem Modifikator 'nodefaults'
&uuml;bergeben. Als Beispiel: {$var|smarty:nodefaults}.
Zum Beispiel: {$var|nodefaults}. Zum Beispiel: {$var|nodefaults}.
</para> </para>
</sect1> </sect1>
<sect1 id="variable.default.resource.type">
<title>$default_resource_type</title>
<para>
Definiert den Ressourcentyp der von Smarty implizitverwendet werden soll. Standartwert
ist 'file', was dazu f&uuml;hrt dass $smarty->display('index.tpl'); und
$smarty->display('file:index.tpl'); identisch sind. Konsultieren Sie das
<link linkend="template.resources">Resource</link> Kapitel f&uuml;r weitere Informationen.
</para>
</sect1>
</chapter> </chapter>
<chapter id="api.functions"> <chapter id="api.functions">
<title>Methoden</title> <title>Methoden</title>
@@ -447,27 +481,12 @@
<paramdef>string <parameter>varname</parameter></paramdef> <paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype> </funcprototype>
<funcprototype>
<funcdef>void <function>append</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
<paramdef>boolean <parameter>merge</parameter></paramdef>
</funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
Wird verwendet, um an Template-Variablen weitere Daten anzuh&auml;ngen. Sie Wird verwendet, um an Template-Variablen weitere Daten anzuh&auml;ngen. Sie
k&ouml;nnen entweder ein Namen/Wert-Paar oder assoziative Arrays, k&ouml;nnen entweder ein Namen/Wert-Paar oder assoziative Arrays,
die mehrere Namen/Wert-Paare enthalten, &uuml;bergeben. Wenn Sie als dritten Parameter die mehrere Namen/Wert-Paare enthalten, &uuml;bergeben.
'true' &uuml;bergeben werden die beiden Arrays zusammengef&uuml;gt.
</para> </para>
<note>
<title>Technical Note</title>
<para>
Der Parameter 'merge' &uuml;berschreibt bestehende Schl&uuml;ssel, falls
im zweiten Array die selben Schl&uuml;ssel wie im ersten vorkommen.
Diese Funktion ist ungelich 'array_merge()' aus PHP.
</para>
</note>
<example> <example>
<title>append (anh&auml;ngen)</title> <title>append (anh&auml;ngen)</title>
<programlisting> <programlisting>
@@ -488,27 +507,20 @@
<paramdef>string <parameter>varname</parameter></paramdef> <paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype> </funcprototype>
<funcprototype>
<funcdef>void <function>append_by_ref</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
<paramdef>boolean <parameter>merge</parameter></paramdef>
</funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
Wird verwendet, um an Template-Variablen Werte via Referenz (pass by reference) anstatt via Kopie Wird verwendet, um an Template-Variablen Werte via Referenz (pass by reference) anstatt via Kopie
anzuh&auml;ngen. Wenn Sie eine Variable via Referenz anh&auml;ngen und sie nachtr&auml;glich anzuh&auml;ngen. Konsultieren Sie das PHP-Manual zum Thema 'variable referencing'
ge&auml;ndert wird, wird auch der angeh&auml;ngte Wert ge&auml;ndert. Bei Objekten kann so f&uuml;r weitere Erkl&auml;rungen.
das kopieren derselben vermieden werden. Konsultieren Sie das PHP-Manual betreffend Variablenreferenzierung
f&uuml;r weitere Erkl&auml;rungen. Wenn Sie als dritten Parameter 'true' &uuml;bergeben wird das anzuh&auml;ngende Array
mit dem bestehenden zusammengef&uml;gt.
</para> </para>
<note> <note>
<title>Technische Bemerkung</title> <title>Technische Bemerkung</title>
<para> <para>
Der Parameter 'merge' &uuml;berschreibt bestehende Schl&uuml;ssel, falls 'append_by_ref()' ist effizienter als 'append()', da keine Kopie der Variable
im zweiten Array die selben Schl&uuml;ssel wie im ersten vorkommen. erzeugt, sondern auf die Variable im Speicher referenziert wird. Beachten Sie
Diese Funktion ist ungelich 'array_merge()' aus PHP. dabei, dass eine nachtr&auml;gliche &auml;nderung Original-Variable auch die zugewiesene Variable
&auml;ndert. PHP5 wird die Referenzierung automatisch &uuml;bernehmen, diese
Funktion dient als Workaround.
</para> </para>
</note> </note>
<example> <example>
@@ -567,11 +579,11 @@
<note> <note>
<title>Technical Note</title> <title>Technical Note</title>
<para> <para>
Wird verwendet, um an Template-Variablen Werte via Referenz (pass by reference) anstatt via Kopie 'assign_by_ref()' ist effizienter als 'assign()', da keine Kopie der Variable
anzuh&auml;ngen. Wenn Sie eine Variable via Referenz anh&auml;ngen und sie nachtr&auml;glich erzeugt wird, sondern auf die Variable im Speicher referenziert wird. Beachten Sie
ge&auml;ndert wird, wird auch der angeh&auml;ngte Wert ge&auml;ndert. Bei Objekten kann so dabei, dass eine nachtr&auml;gliche &auml;nderung Original-Variable auch die zugewiesene Variable
das kopieren derselben vermieden werden. Konsultieren Sie das PHP-Manual betreffend Variablenreferenzierung &auml;ndert. PHP5 wird die Referenzierung automatisch &uuml;bernehmen, diese
f&uuml;r weitere Erkl&auml;rungen. Funktion dient als Workaround.
</para> </para>
</note> </note>
<example> <example>
@@ -853,80 +865,27 @@
echo $output;</programlisting> echo $output;</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="api.get.config.vars">
<title>get_config_vars</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_config_vars</function></funcdef>
<paramdef>string <parameter><optional>varname</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Gibt die definierte Variable aus einer Konfigurationsdatei zur&uuml;ck,
wenn kein Parameter &uuml;bergeben wird, wird ein Array aller Variablen
zur&uuml;ckgegeben.
</para>
<example>
<title>get_config_vars</title>
<programlisting>
// Vriable 'foo' aus Konfigurationsdatei lesen
$foo = $smarty->get_config_vars('foo');
// alle Variablen aus der Konfigurationsdatei lesen
$config_vars = $smarty->get_config_vars();
// ausgeben
print_r($config_vars);</programlisting>
</example>
</sect1>
<sect1 id="api.get.registered.object">
<title>get_registered_object</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_registered_object</function></funcdef>
<paramdef>string <parameter>object_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This returns a reference to a registered object. This is useful
from within a custom function when you need direct access to a
registered object.
</para>
<example>
<title>get_registered_object</title>
<programlisting>
function smarty_block_foo($params, &amp;$smarty) {
if (isset[$params['object']]) {
// get reference to registered object
$obj_ref =&amp; $smarty->&amp;get_registered_object($params['object']);
// use $obj_ref is now a reference to the object
}
}</programlisting>
</example>
</sect1>
<sect1 id="api.get.template.vars"> <sect1 id="api.get.template.vars">
<title>get_template_vars (Template-Variablen extrahieren)</title> <title>get_template_vars (Template-Variablen extrahieren)</title>
<funcsynopsis> <funcsynopsis>
<funcprototype> <funcprototype>
<funcdef>array <function>get_template_vars</function></funcdef> <funcdef>array <function>get_template_vars</function></funcdef>
<paramdef>string <parameter><optional>varname</optional></parameter></paramdef> <paramdef><parameter></parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
Gibt den Wert der &uuml;bergebenen Template-Variable zur&uuml;ck. Wenn kein Parameter Gibt ein Array der zugewiesenen Template-Variablen zur&uuml;ck.
&uuml;bergeben wird, besteht die R&uuml;ckgabe aus einem Array aller zugewiesener Variablen.
</para> </para>
<example> <example>
<title>get_template_vars (Template-Variablen extrahieren)</title> <title>get_template_vars (Template-Variablen extrahieren)</title>
<programlisting> <programlisting>
// Template-Variable 'foo' extrahieren
$foo = $smarty->get_template_vars('foo');
// alle zugewiesenen Template-Variablen extrahieren // alle zugewiesenen Template-Variablen extrahieren
$tpl_vars = $smarty->get_template_vars(); $tpl_vars = $smarty->get_template_vars();
// Anschauen // Anschauen
print_r($tpl_vars);</programlisting> var_dump($tpl_vars);</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="api.is.cached"> <sect1 id="api.is.cached">
@@ -1000,13 +959,24 @@
<funcprototype> <funcprototype>
<funcdef>void <function>register_block</function></funcdef> <funcdef>void <function>register_block</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef> <paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef> <paramdef>mixed <parameter>impl</parameter></paramdef>
<paramdef>bool <parameter>cacheable</parameter></paramdef>
<paramdef>array or null <parameter>cache_attrs</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
Wird verwendet, um Block-Funktion-Plugins dynamisch zu registrieren. Wird verwendet, um Block-Funktion-Plugins dynamisch zu registrieren.
&Uuml;bergeben Sie dazu den Namen der Block-Funktion und den Namen der &Uuml;bergeben Sie dazu den Namen der Block-Funktion und den Namen der
PHP-Funktion, die die entsprechende Funktionalit&auml;t bereitstellt. PHP-Callback-Funktion, die die entsprechende Funktionalit&auml;t bereitstellt.
</para>
<para>
Der Parameter <parameter>impl</parameter> kann als (a) einen Funktionnamen oder (b) einem Array der Form <literal>array(&$object, $method)</literal>,
wobei <literal>&$object</literal> eine Referenz zu einem Objekt und <literal>$method</literal> der Name der Methode die aufgerufen werden soll ist,
oder als Array der Form <literal>array(&$class, $method)</literal>, wobei <literal>$class</literal> der Name der Klasse und <literal>$method</literal>
der Name der Methode ist die aufgerufen werden soll, &uuml;bergeben werden.
</para>
<para>
<parameter>$cacheable</parameter> und <parameter>$cache_attrs</parameter> k&ouml;nnen in den meisten F&auml;llen weggelassen werden. Konsultieren Sie <link linkend="caching.cacheable">Die Ausgabe von cachebaren Plugins Kontrollieren</link> f&uuml;r weitere Informationen.
</para> </para>
<example> <example>
<title>register_block (Block-Funktion registrieren)</title> <title>register_block (Block-Funktion registrieren)</title>
@@ -1014,12 +984,12 @@
/* PHP */ /* PHP */
$smarty->register_block("translate", "do_translation"); $smarty->register_block("translate", "do_translation");
function do_translation ($params, $content, &$smarty) { function do_translation ($params, $content, &$smarty, &amp;$repeat) {
if ($content) { if (isset($content)) {
$lang = $params['lang']; $lang = $params['lang'];
// &uuml;bersetze den Inhalt von '$content' // &uuml;bersetze den Inhalt von '$content'
echo $translation; return $translation;
} }
} }
@@ -1035,7 +1005,8 @@
<funcprototype> <funcprototype>
<funcdef>void <function>register_compiler_function</function></funcdef> <funcdef>void <function>register_compiler_function</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef> <paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef> <paramdef>mixed <parameter>impl</parameter></paramdef>
<paramdef>bool <parameter>cacheable</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
@@ -1043,6 +1014,15 @@
registrieren. &Uuml;bergeben Sie dazu den Namen der Compiler-Funktion und den Namen der registrieren. &Uuml;bergeben Sie dazu den Namen der Compiler-Funktion und den Namen der
PHP-Funktion, die die entsprechende Funktionalit&auml;t bereitstellt. PHP-Funktion, die die entsprechende Funktionalit&auml;t bereitstellt.
</para> </para>
<para>
Der Parameter <parameter>impl</parameter> kann als (a) einen Funktionnamen oder (b) einem Array der Form <literal>array(&$object, $method)</literal>,
wobei <literal>&$object</literal> eine Referenz zu einem Objekt und <literal>$method</literal> der Name der Methode die aufgerufen werden soll ist,
oder als Array der Form <literal>array(&$class, $method)</literal>, wobei <literal>$class</literal> der Name der Klasse und <literal>$method</literal>
der Name der Methode ist die aufgerufen werden soll, &uuml;bergeben werden.
</para>
<para>
<parameter>$cacheable</parameter> und <parameter>$cache_attrs</parameter> k&ouml;nnen in den meisten F&auml;llen weggelassen werden. Konsultieren Sie <link linkend="caching.cacheable">Die Ausgabe von cachebaren Plugins Kontrollieren</link> f&uuml;r weitere Informationen.
</para>
</sect1> </sect1>
<sect1 id="api.register.function"> <sect1 id="api.register.function">
<title>register_function (Funktion registrieren)</title> <title>register_function (Funktion registrieren)</title>
@@ -1050,14 +1030,24 @@
<funcprototype> <funcprototype>
<funcdef>void <function>register_function</function></funcdef> <funcdef>void <function>register_function</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef> <paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef> <paramdef>mixed <parameter>impl</parameter></paramdef>
<paramdef>bool <parameter>cacheable</parameter></paramdef>
<paramdef>array or null <parameter>cache_attrs</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
Wird verwendet, um Template-Funktion-Plugins dynamisch zu Wird verwendet, um Template-Funktion-Plugins dynamisch zu
registrieren. &Uuml;bergeben Sie dazu den Namen der Template-Funktion registrieren. &Uuml;bergeben Sie dazu den Namen der Template-Funktion
und den Namen der PHP-Funktion, die die entsprechende Funktionalit&auml;t bereitstellt. und den Namen der PHP-Funktion, die die entsprechende Funktionalit&auml;t bereitstellt.
</para>
<para>
Der Parameter <parameter>impl</parameter> kann als (a) einen Funktionnamen oder (b) einem Array der Form <literal>array(&$object, $method)</literal>,
wobei <literal>&$object</literal> eine Referenz zu einem Objekt und <literal>$method</literal> der Name der Methode die aufgerufen werden soll ist,
oder als Array der Form <literal>array(&$class, $method)</literal>, wobei <literal>$class</literal> der Name der Klasse und <literal>$method</literal>
der Name der Methode ist die aufgerufen werden soll, &uuml;bergeben werden.
</para>
<para>
<parameter>$cacheable</parameter> und <parameter>$cache_attrs</parameter> k&ouml;nnen in den meisten F&auml;llen weggelassen werden. Konsultieren Sie <link linkend="caching.cacheable">Die Ausgabe von cachebaren Plugins Kontrollieren</link> f&uuml;r weitere Informationen.
</para> </para>
<example> <example>
<title>register_function (Funktion registrieren)</title> <title>register_function (Funktion registrieren)</title>
@@ -1068,7 +1058,7 @@
extract($params); extract($params);
if(empty($format)) if(empty($format))
$format="%b %e, %Y"; $format="%b %e, %Y";
echo strftime($format,time()); return strftime($format,time());
} }
// Von nun an k&ouml;nnen Sie {date_now} verwenden, um das aktuelle Datum auszugeben. // Von nun an k&ouml;nnen Sie {date_now} verwenden, um das aktuelle Datum auszugeben.
@@ -1081,7 +1071,7 @@
<funcprototype> <funcprototype>
<funcdef>void <function>register_modifier</function></funcdef> <funcdef>void <function>register_modifier</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef> <paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef> <paramdef>mixed <parameter>impl</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
@@ -1090,6 +1080,12 @@
und den Namen der PHP-Funktion, die die entsprechende Funktionalit&auml;t und den Namen der PHP-Funktion, die die entsprechende Funktionalit&auml;t
bereitstellt. bereitstellt.
</para> </para>
<para>
Der Parameter <parameter>impl</parameter> kann als (a) einen Funktionnamen oder (b) einem Array der Form <literal>array(&$object, $method)</literal>,
wobei <literal>&$object</literal> eine Referenz zu einem Objekt und <literal>$method</literal> der Name der Methode die aufgerufen werden soll ist,
oder als Array der Form <literal>array(&$class, $method)</literal>, wobei <literal>$class</literal> der Name der Klasse und <literal>$method</literal>
der Name der Methode ist die aufgerufen werden soll, &uuml;bergeben werden.
</para>
<example> <example>
<title>register_modifier (Modifikator-Plugin registrieren)</title> <title>register_modifier (Modifikator-Plugin registrieren)</title>
<programlisting> <programlisting>
@@ -1103,19 +1099,42 @@
// um "\"-Zeichen (Backslash) aus Zeichenketten zu entfernen. ('\\' wird zu '\',...)</programlisting> // um "\"-Zeichen (Backslash) aus Zeichenketten zu entfernen. ('\\' wird zu '\',...)</programlisting>
</example> </example>
</sect1> </sect1>
<sect1 id="api.register.object">
<title>register_object</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_object</function></funcdef>
<paramdef>string <parameter>object_name</parameter></paramdef>
<paramdef>object <parameter>$object</parameter></paramdef>
<paramdef>array <parameter>allowed methods/properties</parameter></paramdef>
<paramdef>boolean <parameter>format</parameter></paramdef>
<paramdef>array <parameter>block methods</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Wird verwendet um ein Objekt zu registrieren. Konsultieren Sie den Abschnitt <link linkend="advanced.features.objects">Objekte</link>
f&uuml;r weitere Informationen und Beispiele.
</para>
</sect1>
<sect1 id="api.register.outputfilter"> <sect1 id="api.register.outputfilter">
<title>register_outputfilter (Ausgabefilter registrieren)</title> <title>register_outputfilter (Ausgabefilter registrieren)</title>
<funcsynopsis> <funcsynopsis>
<funcprototype> <funcprototype>
<funcdef>void <function>register_outputfilter</function></funcdef> <funcdef>void <function>register_outputfilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef> <paramdef>mixed <parameter>function</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
Wird verwendet, um Ausgabefilter dynamisch zu registrieren. Verwenden Sie diese Funktion um dynamisch Ausgabefilter zu registrieren, welche
Ausgabefilter ver&auml;ndern die Ausgabe, die Template Ausgabe verarbeiten bevor sie angezeigt wird. Konsultieren Sie
bevor sie angezeigt wird. Konsultieren Sie dazu den den Abschnitt &uuml;ber <link linkend="advanced.features.outputfilters">Ausgabefilter</link>
Abschnitt <link linkend="advanced.features.outputfilters">template output filters</link> f&uuml;r mehr Informationen.
</para>
<para>
Der Parameter <parameter>function</parameter> kann als (a) einen Funktionnamen oder (b) einem Array der Form <literal>array(&$object, $method)</literal>,
wobei <literal>&$object</literal> eine Referenz zu einem Objekt und <literal>$method</literal> der Name der Methode die aufgerufen werden soll ist,
oder als Array der Form <literal>array(&$class, $method)</literal>, wobei <literal>$class</literal> der Name der Klasse und <literal>$method</literal>
der Name der Methode ist die aufgerufen werden soll, &uuml;bergeben werden.
</para> </para>
</sect1> </sect1>
<sect1 id="api.register.postfilter"> <sect1 id="api.register.postfilter">
@@ -1123,7 +1142,7 @@
<funcsynopsis> <funcsynopsis>
<funcprototype> <funcprototype>
<funcdef>void <function>register_postfilter</function></funcdef> <funcdef>void <function>register_postfilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef> <paramdef>mixed <parameter>function</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
@@ -1131,20 +1150,31 @@
auf das kompilierte Template angewendet. Konsultieren Sie dazu den auf das kompilierte Template angewendet. Konsultieren Sie dazu den
Abschnitt <link linkend="advanced.features.postfilters">template postfilters</link>. Abschnitt <link linkend="advanced.features.postfilters">template postfilters</link>.
</para> </para>
<para>
Der Parameter <parameter>function</parameter> kann als (a) einen Funktionnamen oder (b) einem Array der Form <literal>array(&$object, $method)</literal>,
wobei <literal>&$object</literal> eine Referenz zu einem Objekt und <literal>$method</literal> der Name der Methode die aufgerufen werden soll ist,
oder als Array der Form <literal>array(&$class, $method)</literal>, wobei <literal>$class</literal> der Name der Klasse und <literal>$method</literal>
der Name der Methode ist die aufgerufen werden soll, &uuml;bergeben werden.
</para>
</sect1> </sect1>
<sect1 id="api.register.prefilter"> <sect1 id="api.register.prefilter">
<title>register_prefilter ('pre'-Filter registrieren)</title> <title>register_prefilter ('pre'-Filter registrieren)</title>
<funcsynopsis> <funcsynopsis>
<funcprototype> <funcprototype>
<funcdef>void <function>register_prefilter</function></funcdef> <funcdef>void <function>register_prefilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef> <paramdef>mixed <parameter>function</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<para> <para>
Wird verwendet, um 'pre'-Filter dynamisch zu registrieren. 'pre'-Filter werden Wird verwendet, um 'pre'-Filter dynamisch zu registrieren. 'pre'-Filter werden
vor der Kompilierung auf das Template angewendet. Konsultieren Sie dazu den vor der Kompilierung auf das Template angewendet. Konsultieren Sie dazu den
Abschnitt <link linkend="advanced.features.prefilters">template prefilters</link>. Abschnitt <link linkend="advanced.features.prefilters">'pre'-Filter</link>.
</para>
<para>
Der Parameter <parameter>function</parameter> kann als (a) einen Funktionnamen oder (b) einem Array der Form <literal>array(&$object, $method)</literal>,
wobei <literal>&$object</literal> eine Referenz zu einem Objekt und <literal>$method</literal> der Name der Methode die aufgerufen werden soll ist,
oder als Array der Form <literal>array(&$class, $method)</literal>, wobei <literal>$class</literal> der Name der Klasse und <literal>$method</literal>
der Name der Methode ist die aufgerufen werden soll, &uuml;bergeben werden.
</para> </para>
</sect1> </sect1>
<sect1 id="api.register.resource"> <sect1 id="api.register.resource">
@@ -1163,6 +1193,18 @@
Konsultieren Sie den Abschnitt <link linkend="template.resources">template resources</link> Konsultieren Sie den Abschnitt <link linkend="template.resources">template resources</link>
f&uuml;r weitere Informationen zum Thema. f&uuml;r weitere Informationen zum Thema.
</para> </para>
<note>
<title>Technische Bemerkung</title>
<para>
Ein Ressourcename muss mindestens 2 Zeichen lang sein. Namen mit einem (1) Zeichen
werden ignoriert und als Teil des Pfades verwenden, wie in $smarty->display('c:/path/to/index.tpl');.
</para>
</note>
<para>
Der Parameter <parameter>resource_funcs</parameter> muss aus 4 oder 5 Elementen bestehen. Wenn 4 Elemente &uuml;bergeben werden,
werden diese als Ersatz Callback-Funktionen f&uuml; "source", "timestamp", "secure" und "trusted" verwendet. Mit 5 Elementen
muss der erste Parameter eine Referenz auf das Objekt oder die Klasse sein, welche die ben&ouml;tigten Methoden bereitstellt.
</para>
<example> <example>
<title>register_resource (Ressource registrieren)</title> <title>register_resource (Ressource registrieren)</title>
<programlisting> <programlisting>
@@ -1397,7 +1439,7 @@
$smarty->caching = 2; // Lebensdauer ist pro Cache $smarty->caching = 2; // Lebensdauer ist pro Cache
// Standardwert f&uuml;r '$cache_lifetime' auf 15 Minuten setzen // Standardwert f&uuml;r '$cache_lifetime' auf 5 Minuten setzen
$smarty->cache_lifetime = 300; $smarty->cache_lifetime = 300;
$smarty->display('index.tpl'); $smarty->display('index.tpl');
@@ -1622,9 +1664,170 @@
</para> </para>
</note> </note>
</sect1> </sect1>
<sect1 id="caching.cacheable">
<title>Die Ausgabe von cachebaren Plugins Kontrollieren</title>
<para>
Seit Smarty-2.6.0 kann bei der Registrierung angegeben werden ob ein Plugin
cached werden soll. Der dritte Parameter f&uuml;r register_block, register_compiler_function
und register_function heisst <parameter>$cacheable</parameter>, der Standardwert ist TRUE, was in Smarty vor
Version 2.6.0 &uuml;blich war.
</para>
<para>
Wenn ein Plugin mit $cacheable=false registriert wird, wird er bei jedem Besuch der Seite aufgerufen, selbst wenn die Site aus dem Cache stammt. Die Pluginfunktion verh&auml;lt sich ein wenig wie <link linkend="plugins.inserts">insert</link>.
</para>
<para>
Im Gegensatz zu <link linkend="language.function.insert">{insert}</link> werden die Attribute standartm&auml;ssig nicht gecached. Sie k&ouml;nnen das caching jedoch mit dem vierten Parameter <parameter>$cache_attrs</parameter> kontrollieren. <parameter>$cache_attrs</parameter> ist ein Array aller Attributnamen die gecached wertden sollen.
</para>
<example>
<title>Preventing a plugin's output from being cached</title>
<programlisting>
index.php:
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->caching = true;
function remaining_seconds($params, &$smarty) {
$remain = $params['endtime'] - time();
if ($remain >=0)
return $remain . " second(s)";
else
return "done";
}
$smarty->register_function('remaining', 'remaining_seconds', false, array('endtime'));
if (!$smarty->is_cached('index.tpl')) {
// objekt $obj aus datenbank dem template zuweisen
$smarty->assign_by_ref('obj', $obj);
}
$smarty->display('index.tpl');
index.tpl:
Time Remaining: {remain endtime=$obj->endtime}</programlisting>
<para>
Der Wert von $obj->endtime &auml;ndert bei jeder Anzeige der Seite, selbst wenn die Seite gecached wurde. Das Objekt $obj wird nur geladen wenn die Seite nicht gecached wurde.
</para>
</example>
<example>
<title>Verhindern dass Template Bl&ouml;cke gecached werden</title>
<programlisting>
index.php:
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->caching = true;
function smarty_block_dynamic($param, $content, &$smarty) {
return $content;
}
$smarty->register_block('dynamic', 'smarty_block_dynamic', false);
$smarty->display('index.tpl');
index.tpl:
Page created: {"0"|date_format:"%D %H:%M:%S"}
{dynamic}
Now is: {"0"|date_format:"%D %H:%M:%S"}
... do other stuff ...
{/dynamic}</programlisting>
</example>
<para>
Um sicherzustellen dass ein Teil eines Templates nicht gecached werden soll, kann dieser Abschnitt in einen {dynamic}...{/dynamic} Block verpackt werden.
</para>
</sect1>
</chapter> </chapter>
<chapter id="advanced.features"> <chapter id="advanced.features">
<title>Advanced Features</title> <title>Advanced Features</title>
<sect1 id="advanced.features.objects">
<title>Objekte</title>
<para>
Smarty erlaubt es, auf PHP Objekt durch das Template zuzugreiffen. Daf&uuml;r gitbt es
zwei Wege. Der erste ist, Objekte zu registrieren und wie auf eigene Funktionen zuzugreiffen.
Der andere Weg ist, das Objekt dem Template zuzuweisen und darauf wie auf andere Variablen
zuzugreiffen. Die erste Methode hat eine nettere Template Syntax und ist sicherer da der Zugriff
auf ein registriertes Objekt mit Sicherheitseinstellungen kontrolliert werden kann. Der Nachteil
ist, dass registrierte Objekte nicht in Loops verwendet werden k<>nnen. Welchen Weg Sie einschlagen
wird von Ihren Bed&uuml;rfnissen definiert, die erste Methode ist jedoch zu bevorzugen.
</para>
<para>
Wenn Sicherheit eingeschaltet ist, k&ouml;nnen keine private Methoden (solche die einen '_'-Prefix tragen)
aufgerufen werden. Wenn eine Methode und eine Eigeschaft mit dem gleichen Namen existieren wird die Methode
verwendet.
</para>
<para>
Sie k&ouml;nnen den Zugriff auf Methoden und Eigenschaften einschr&auml;nken
indem Sie sie als Array als dritten Registrationsparameter &uuml;bergeben.
</para>
<para>
Normalerweise werden Parameter welche einem Objekt via Template &uuml;bergeben
werden genau so &uuml;bergeben wie dies bei normalen eigenen Funktionen der Fall ist.
Das erste Objekt ist ein assoziatives Array und das zweite das Smarty Objekt selbst.
Wenn Sie die Parameter einzeln erhalten m&ouml;chten k&ouml;nnen Sie den vierten
Parameter auf FALSE setzen.
</para>
<para>
Der optional f&uuml;nfte Parameter hat nur einen Effekt wenn
<parameter>format</parameter> <literal>true</literal> ist und eine Liste von
Methoden enth&auml;lt die als Block verarbeitet werden sollen.
Das bedeutet dass solche Methoden ein schliessendes Tag im Template
enthalten m&uuml;ssen (<literal>{foobar->meth2}...{/foobar->meth2}</literal>)
und die Parameter zu den Funktionen die selbe Syntax haben wie block-function-plugins:
sie erhalten 4 Parameter
<parameter>$params</parameter>,
<parameter>$content</parameter>,
<parameter>&$smarty</parameter> und
<parameter>&$repeat</parameter>
und sich auch wie block-function-plugins verhalten.
</para>
<example>
<title>ein registiertes oder zugewiesenes Objekt verwenden</title>
<programlisting>
&lt;?php
// das objekt
class My_Object {
function meth1($params, &$smarty_obj) {
return "meine meth1";
}
}
$myobj = new My_Object;
// objekt registrieren (referenz)
$smarty->register_object("foobar",$myobj);
// zugriff auf methoden und eigeschaften einschr&auml;nken
$smarty->register_object("foobar",$myobj,array('meth1','meth2','prop1'));
// wenn wir das traditionelle parameter format verwenden wollen, &uuml;bergeben wir false f&uuml;r den parameter format
$smarty->register_object("foobar",$myobj,null,false);
// objekte zuweisen (auch via referenz m&ouml;glich)
$smarty->assign_by_ref("myobj", $myobj);
$smarty->display("index.tpl");
?&gt;
TEMPLATE:
{* zugriff auf ein registriertes objekt *}
{foobar->meth1 p1="foo" p2=$bar}
{* ausgabe zuweisen *}
{foobar->meth1 p1="foo" p2=$bar assign="output"}
ausgabe war: {$output}
{* auf unser zugewiesenes objekt zugreiffen *}
{$myobj->meth1("foo",$bar)}</programlisting>
</example>
</sect1>
<sect1 id="advanced.features.prefilters"> <sect1 id="advanced.features.prefilters">
<title>'pre'-Filter</title> <title>'pre'-Filter</title>
<para> <para>
@@ -1878,7 +2081,9 @@
ein Template mit 'display()' ausgeben, die Ausgabe mit 'fetch()' ein Template mit 'display()' ausgeben, die Ausgabe mit 'fetch()'
in einer Variablen speichern oder innnerhalb eines Template ein in einer Variablen speichern oder innnerhalb eines Template ein
weiteres Template einbinden, m&uuml;ssen Sie den Ressourcen-Typ, weiteres Template einbinden, m&uuml;ssen Sie den Ressourcen-Typ,
gefolgt von Pfad und Template-Namen angeben. gefolgt von Pfad und Template-Namen angeben. Wenn kein Resourcetyp angegeben
wird, wird <link linkend="variable.default.resource.type">$default_resource_type</link>
verwendet.
</para> </para>
<sect2 id="templates.from.template.dir"> <sect2 id="templates.from.template.dir">
<title>Templates aus dem '$template_dir'</title> <title>Templates aus dem '$template_dir'</title>
@@ -2116,9 +2321,9 @@
entspricht der Reihenfolge in der sie geladen/registriert wurden. entspricht der Reihenfolge in der sie geladen/registriert wurden.
</para> </para>
<para> <para>
Aus Performancegr&uuml;nden existiert nur ein Plugin-Verzeichnis. Um ein Plugin Die <link linkend="variable.plugins.dir">plugins directory</link> Variable kann eine Zeichenkette,
zu installieren, speichern Sie es einfach in diesem Verzeichnis. Smarty wird oder ein Array mit Verzeichnisnamen sein. Um einen Plugin zu installieren k&ouml;nnen Sie ihn einfach
es danach automatisch erkennen. in einem der Verzeichnisse ablegen.
</para> </para>
</sect1> </sect1>
@@ -2198,10 +2403,11 @@
folgender Weg gew&auml;hlt werden, um das ben&ouml;tigte Plugin zu laden: folgender Weg gew&auml;hlt werden, um das ben&ouml;tigte Plugin zu laden:
</para> </para>
<programlisting> <programlisting>
require_once SMARTY_DIR . 'plugins/function.html_options.php';</programlisting> require_once $smarty->_get_plugin_filepath('function', 'html_options');</programlisting>
<para> <para>
Das Smarty Objekt wird jedem Plugin immer als letzter Parameter Das Smarty Objekt wird jedem Plugin immer als letzter Parameter
&uuml;bergeben (ausser bei Variablen-Modifikatoren). &uuml;bergeben (ausser bei Variablen-Modifikatoren und bei Bl&uuml;cken wird
<parameter>&amp;$repeat</parameter> nach dem Smarty Objekt &uuml;bergeben um R&uuml;ckw&auml;rtskompatibel zu bleiben).
</para> </para>
</sect1> </sect1>
@@ -2413,7 +2619,8 @@
<para> <para>
Ihre Funktions-Implementation wird von Smarty zweimal Ihre Funktions-Implementation wird von Smarty zweimal
aufgerufen: einmal f&uuml;r das &ouml;ffnende und einmal aufgerufen: einmal f&uuml;r das &ouml;ffnende und einmal
f&uuml;r das schliessende Tag. f&uuml;r das schliessende Tag. (konsultieren Sie den Abschnitt zu <literal>&amp;$repeat</literal>
um zu erfahren wie Sie dies &auml;ndern k&ouml;nnen.)
</para> </para>
<para> <para>
Nur das &Ouml;ffnungs-Tag kann Attribute enthalten. Alle so &uuml;bergebenen Attribute Nur das &Ouml;ffnungs-Tag kann Attribute enthalten. Alle so &uuml;bergebenen Attribute
@@ -2431,6 +2638,15 @@
Achtung: Der Template-Abschnitt den Sie erhalten, wurde bereits von Achtung: Der Template-Abschnitt den Sie erhalten, wurde bereits von
Smarty bearbeitet. Sie erhalten also die Template-Ausgabe, nicht den Template-Quelltext. Smarty bearbeitet. Sie erhalten also die Template-Ausgabe, nicht den Template-Quelltext.
</para> </para>
<para>
Der Parameter <parameter>&amp;$repeat</parameter> wird als Referenz &uuml;bergeben und
kontrolliert wie oft ein Block dargestellt werden soll. Standardwert von <parameter>$repeat</parameter>
ist beim ersten Aufruf (f&uuml;r das &ouml;ffnende Tag) <literal>true</literal>, danach immer
<literal>false</literal>.
Jedes Mal wenn eine Funktion f&uuml;r <parameter>&amp;$repeat</parameter> TRUE zur&uum;ck gibt,
wird der Inhalt zwischen {func} .. {/func} erneut mit dem ver&auml;nderten
Inhalt als <parameter>$content</parameter> Parameter aufgerufen.
</para>
<para> <para>
Wenn Sie verschachtelte Block-Funktionen haben, k&ouml;nnen Sie Wenn Sie verschachtelte Block-Funktionen haben, k&ouml;nnen Sie
die Eltern-Block-Funktion mit der <varname>$smarty->_tag_stack</varname> Variable die Eltern-Block-Funktion mit der <varname>$smarty->_tag_stack</varname> Variable
@@ -2458,11 +2674,11 @@
*/ */
function smarty_block_translate($params, $content, &amp;$smarty) function smarty_block_translate($params, $content, &amp;$smarty)
{ {
if ($content) { if (isset($content)) {
$lang = $params['lang']; $lang = $params['lang'];
// den $content irgendwie intelligent &uuml;bersetzuen // den $content irgendwie intelligent &uuml;bersetzuen
echo $translation; return $translation;
} }
}</programlisting> }</programlisting>
</example> </example>