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

sync with en

Browse Source
This commit is contained in:
messju
2005-06-24 09:02:38 +00:00
parent 25ec77ca15
commit 4d7485f489
6 changed files with 1023 additions and 728 deletions
Download Patch File Download Diff File Expand all files Collapse all files

237
docs/de/designers/language-builtin-functions/language-function-insert.xml
View File

@@ -1,121 +1,128 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: andreas Status: ready -->
<sect1 id="language.function.insert">
<title>insert (einf&uuml;gen)</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>Erforderlich</entry>
<entry>Standardwert</entry>
<entry>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Ja</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Der Name der Insert-Funktion</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Name der Template-Variable, in der die Ausgabe der 'insert'-Funktion optional abgelegt wird.</entry>
</row>
<row>
<entry>script</entry>
<entry>string</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Name des PHP-Skriptes, das vor Aufruf der 'insert'-Funktion eingebunden werden soll.</entry>
</row>
<row>
<entry>[var ...]</entry>
<entry>[var typ]</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Variablen die der 'insert'-Funktion &uuml;bergeben werden sollen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
'insert'-Tags funktionieren &auml;hnlich den 'include'-Tags,
werden aber nicht gecached, falls <link linkend="caching">caching</link>
eingeschaltet ist. Sie werden bei jedem Aufruf des Templates ausgef&uuml;hrt.
</para>
<para>
Stellen Sie sich vor, sie h&auml;tten ein Template mit einem
Werbebanner. Dieser Banner kann verschiedene Arten von
Inhalten haben: Bilder, HTML, Flash, etc.
Deshalb k&ouml;nnen wir nicht einfach einen statischen Link
verwenden und m&uuml;ssen vermeiden, dass dieser Inhalt gecached wird.
Hier kommt das 'insert'-Tag ins Spiel. Das Template kennt die Variablen
'#banner_location_id#' und '#site_id#' (zum Beispiel aus einer Konfigurationsdatei)
und soll eine Funktion aufrufen, die den Inhalt des Banners liefert.
</para>
<example>
<title>Funktion 'insert'</title>
<programlisting>
<!-- EN-Revision: 1.5 Maintainer: andreas Status: ready -->
<sect1 id="language.function.insert">
<title>insert (einf<EFBFBD>gen)</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>Erforderlich</entry>
<entry>Standardwert</entry>
<entry>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Ja</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Der Name der Insert-Funktion</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Name der Template-Variable, in der die Ausgabe der 'insert'-Funktion optional abgelegt wird.</entry>
</row>
<row>
<entry>script</entry>
<entry>string</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Name des PHP-Skriptes, das vor Aufruf der 'insert'-Funktion eingebunden werden soll.</entry>
</row>
<row>
<entry>[var ...]</entry>
<entry>[var typ]</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Variablen die der 'insert'-Funktion <EFBFBD>bergeben werden sollen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
{insert}-Tags funktionieren <EFBFBD>hnlich den <link
linkend="language.function.include">{include}</link>-Tags, werden
aber nicht gecached, falls <link linkend="caching">caching</link>
eingeschaltet ist. Sie werden bei jedem Aufruf des Templates
ausgef<EFBFBD>hrt.
</para>
<para>
Stellen Sie sich vor, sie h<>tten ein Template mit einem
Werbebanner. Dieser Banner kann verschiedene Arten von Inhalten
haben: Bilder, HTML, Flash, etc. Deshalb k<>nnen wir nicht einfach
einen statischen Link verwenden und m<>ssen vermeiden, dass dieser
Inhalt gecached wird. Hier kommt das {insert}-Tag ins Spiel. Das
Template kennt die Variablen '#banner_location_id#' und '#site_id#'
(zum Beispiel aus einer <link
linkend="config.files">Konfigurationsdatei</link>) und soll eine
Funktion aufrufen, die den Inhalt des Banners liefert.
</para>
<example>
<title>Funktion 'insert'</title>
<programlisting>
{* erzeugen des Banners *}
{insert name="getBanner" lid=#banner_location_id# sid=#site_id#}</programlisting>
</example>
<para>
In diesem Beispiel verwenden wir die Funktion 'getBanner' und
&uuml;bergeben die Parameter '#banner_location_id#' und '#site_id#'.
Smarty wird daraufhin in Ihrer Applikatiopn nach einer Funktion
namens 'getBanner' suchen und diese mit den Parametern '#banner_location_id#'
und '#site_id#' aufrufen. Allen 'insert'-Funktionen in Ihrer Applikation
muss 'insert_' vorangestellt werden, um Konflikte im Namensraum
zu vermeiden. Ihre 'insert_getBanner()'-Funktion sollte etwas mit den
&uuml;bergebenen Parametern unternehmen und das Resultat zur&uuml;ckgeben.
Dieses Resultat wird an der Stelle des 'insert'-Tags in Ihrem Template ausgegeben.
In diesem Beispiel w&uuml;rde Smarty folgende Funktion aufrufen:
insert_getBanner(array("lid" => "12345","sid" => "67890")) und die erhaltenen Resultate
an Stelle des 'insert'-Tags ausgeben.
</para>
<para>
Falls Sie das 'assign'-Attribut &uuml;bergeben, wird die Ausgabe
des 'insert'-Tags in dieser Variablen abgelegt.
Bemerkung: dies ist nicht sinnvoll, wenn Caching eingeschaltet ist.
</para>
<para>
Falls Sie das 'script'-Attribut &uuml;bergeben, wird das angegebene
PHP-Skript vor der Ausf&uuml;hrung der 'insert'-Funktion eingebunden.
Dies ist n&uuml;tzlich, um die 'insert'-Funktion erst in diesem
Skript zu definieren.
Der Pfad kann absolut oder relativ zu '$trusted_dir' angegeben werden.
Wenn Sicherheit eingeschaltet ist, muss das Skript in '$trusted_dir'
liegen.
</para>
<para>
Als zweites Argument wird der 'insert'-Funktion das Smarty-Objekt selbst
&uuml;bergeben. Damit kann dort auf die Informationen im Smarty-Objekt
zugegriffen werden.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
Es gibt die M&ouml;glichkeit, Teile des Templates nicht zu cachen.
Wenn Sie <link linkend="caching">caching</link> eingeschaltet haben,
werden 'insert'-Tags nicht gecached. Sie werden jedesmal ausgef&uuml;hrt, wenn
die Seite erstellt wird - selbst innerhalb gecachter Seiten. Dies funktioniert
gut f&uuml;r Dinge wie Werbung (Banner), Abstimmungen, Wetterberichte, Such-Resultate, Benutzer-Feedback-Ecke, etc.
</para>
</note>
{insert name="getBanner" lid=#banner_location_id# sid=#site_id#}
</programlisting>
</example>
<para>
In diesem Beispiel verwenden wir die Funktion 'getBanner' und
<20>bergeben die Parameter '#banner_location_id#' und '#site_id#'.
Smarty wird daraufhin in Ihrer Applikatiopn nach einer Funktion
namens 'getBanner' suchen und diese mit den Parametern
'#banner_location_id#' und '#site_id#' aufrufen. Allen
'insert'-Funktionen in Ihrer Applikation muss 'insert_'
vorangestellt werden, um Konflikte im Namensraum zu vermeiden. Ihre
'insert_getBanner()'-Funktion sollte etwas mit den <20>bergebenen
Parametern unternehmen und das Resultat zur<75>ckgeben. Dieses
Resultat wird an der Stelle des 'insert'-Tags in Ihrem Template
ausgegeben. In diesem Beispiel w<>rde Smarty folgende Funktion
aufrufen: insert_getBanner(array("lid" => "12345","sid" => "67890"))
und die erhaltenen Resultate an Stelle des 'insert'-Tags ausgeben.
</para>
<para>
Falls Sie das 'assign'-Attribut <20>bergeben, wird die Ausgabe des
'insert'-Tags in dieser Variablen abgelegt. Bemerkung: dies ist
nicht sinnvoll, wenn <link linkend="variable.caching">Caching</link>
eingeschaltet ist.
</para>
<para>
Falls Sie das 'script'-Attribut <20>bergeben, wird das angegebene
PHP-Skript vor der Ausf<73>hrung der {insert}-Funktion eingebunden.
Dies ist n<>tzlich, um die {insert}-Funktion erst in diesem Skript zu
definieren. Der Pfad kann absolut oder relativ zu <link
linkend="variable.trusted.dir">$trusted_dir</link> angegeben werden.
Wenn Sicherheit eingeschaltet ist, muss das Skript in <link
linkend="variable.trusted.dir">$trusted_dir</link> liegen.
</para>
<para>
Als zweites Argument wird der {insert}-Funktion das Smarty-Objekt
selbst <20>bergeben. Damit kann dort auf die Informationen im
Smarty-Objekt zugegriffen werden.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
Es gibt die M<>glichkeit, Teile des Templates nicht zu cachen. Wenn
Sie <link linkend="caching">caching</link> eingeschaltet haben,
werden {insert}-Tags nicht gecached. Sie werden jedesmal
ausgef<65>hrt, wenn die Seite erstellt wird - selbst innerhalb
gecachter Seiten. Dies funktioniert gut f<>r Dinge wie Werbung
(Banner), Abstimmungen, Wetterberichte, Such-Resultate,
Benutzer-Feedback-Ecke, etc.
</para>
</note>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

73
docs/de/designers/language-builtin-functions/language-function-ldelim.xml
View File

@@ -1,27 +1,64 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: andreas Status: ready -->
<sect1 id="language.function.ldelim">
<title>ldelim,rdelim (Ausgabe der Trennzeichen)</title>
<para>
ldelim und rdelim werden verwendet, um die Trennzeichen auszugeben -
in unserem Fall "{" oder "}" - ohne dass Smarty versucht, sie zu
interpretieren.
</para>
<example>
<title>ldelim, rdelim</title>
<programlisting>
<!-- EN-Revision: 1.9 Maintainer: andreas Status: ready -->
<sect1 id="language.function.ldelim">
<title>ldelim,rdelim (Ausgabe der Trennzeichen)</title>
<para>
ldelim und rdelim werden verwendet, um die Trennzeichen auszugeben -
in unserem Fall "{" oder "}" - ohne dass Smarty versucht, sie zu
interpretieren. Um text im Template vor dem Interpretieren zu
schützen kann auch <link
linkend="language.function.literal">{literal}{/literal}</link>
verwendet werden. Siehe auch <link
linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link>.
</para>
<example>
<title>ldelim, rdelim</title>
<programlisting>
<![CDATA[
{* gibt die konfigurierten Trennzeichen des Templates aus *}
{ldelim}funktionsname{rdelim} Funktionen sehen in Smarty so aus!
AUSGABE:
]]>
</programlisting>
<para>
Das obige Beispiel ergibt als Ausgabe:
</para>
<screen>
<![CDATA[
{funktionsname} Funktionen sehen in Smarty so aus!</programlisting>
</example>
</sect1>
]]>
</screen>
<para>
Ein weiteres Beispiel (diesmal mit javascript)
</para>
<programlisting>
<![CDATA[
<script language="JavaScript">
function foo() {ldelim}
... code ...
{rdelim}
</script>
]]>
</programlisting>
<para>
Ausgabe:
</para>
<screen>
<![CDATA[
<script language="JavaScript">
function foo() {
.... code ...
}
</script>
]]>
</screen>
</example>
<para>
Siehe auch <link linkend="language.escaping">Smarty Parsing umgehen</link>
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

66
docs/de/designers/language-builtin-functions/language-function-literal.xml
View File

@@ -1,36 +1,44 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: andreas Status: ready -->
<sect1 id="language.function.literal">
<title>literal</title>
<para>
'literal'-Tags erlauben es, einen Block w&ouml;rtlich auszugeben,
d.h. von der Interpretation durch Smarty auszuschliessen.
Dies ist vor allem f&uuml;r Javascript- oder andere Bl&ouml;cke
n&uuml;tzlich, die geschwungene Klammern verwenden. Alles
was zwischen den {literal}{/literal} Tags steht, wird direkt
angezeigt.</para>
<example>
<title>literal-Tags</title>
<programlisting>
<sect1 id="language.function.literal">
<title>literal</title>
<para>
{literal}-Tags erlauben es, einen Block w<EFBFBD>rtlich auszugeben,
d.h. von der Interpretation durch Smarty auszuschliessen. Dies ist
vor allem f<EFBFBD>r Javascript- oder andere Bl<EFBFBD>cke n<>tzlich, die
geschwungene Klammern verwenden. Alles was zwischen den
{literal}{/literal} Tags steht, wird direkt angezeigt. Wenn in
einem {literal}-Block temlate-Tags verwendet werden sollen, is es
manchmal sinnvoller <link
linkend="language.function.ldelim">{ldelim}{rdelim}</link> statt
{literal} zu verwenden.
</para>
<example>
<title>literal-Tags</title>
<programlisting>
<![CDATA[
{literal}
&lt;script language=javascript&gt;
&lt;!--
function isblank(field) {
if (field.value == '')
{ return false; }
else
{
document.loginform.submit();
return true;
}
}
// --&gt;
&lt;/script&gt;
{/literal}</programlisting>
</example>
<script language=javascript>
<!--
function isblank(field) {
if (field.value == '') {
return false;
} else {
document.loginform.submit();
return true;
}
}
// -->
</script>
{/literal}
]]>
</programlisting>
</example>
<para>
Siehe auch <link linkend="language.escaping">Smarty Parsing
umgehen</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

55
docs/de/designers/language-builtin-functions/language-function-php.xml
View File

@@ -1,23 +1,44 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: andreas Status: ready -->
<sect1 id="language.function.php">
<title>php</title>
<para>
'php'-Tags erlauben es, PHP-Code direkt in das Template einzubetten. Der Inhalt
wird nicht 'escaped', egal wie <link linkend="variable.php.handling">$php_handling</link>
konfiguriert ist.
Dieses Tag ist nur f&uuml;r erfahrene Benutzer gedacht und wird
auch von diesen normalerweise nicht ben&ouml;tigt.
</para>
<example>
<title>php-Tags</title>
<programlisting>
<!-- EN-Revision: 1.6 Maintainer: andreas Status: ready -->
<sect1 id="language.function.php">
<title>php</title>
<para>
{php}-Tags erlauben es, PHP-Code direkt in das Template
einzubetten. Der Inhalt wird nicht 'escaped', egal wie <link
linkend="variable.php.handling">$php_handling</link> konfiguriert
ist. Dieses Tag ist nur f<EFBFBD>r erfahrene Benutzer gedacht und wird
auch von diesen normalerweise nicht ben<EFBFBD>tigt.
</para>
<example>
<title>{php}-Tags</title>
<programlisting>
<![CDATA[
{php}
// php Skript direkt von Template einbinden
include("/pfad/zu/zeige_weather.php");
{/php}</programlisting>
</example>
// php Skript direkt von Template einbinden
include("/pfad/zu/zeige_weather.php");
{/php}
]]>
</programlisting>
</example>
<note>
<title>Technical Note</title>
<para>
Um auf PHP-Variablen in {php}-Bl<42>cken zugreifen zu k<>nnen, kann es
n<>tig sein, die Variable als <ulink
url="&url.php-manual;global">global</ulink> zu deklarieren. Der
{php}-Bl<42>ck l<>uft n<>mlich nicht in einem globalen Kontext, sondern
im Kontext der method des laufenden $smarty-Objektes.
</para>
</note>
<para>
Siehe auch <link
linkend="variable.php.handling">$php_handling</link>, <link
linkend="language.function.include.php">{include_php}</link>, <link
linkend="language.function.include">{include}</link> und <link
linkend="tips.componentized.templates">Template/Script
Komponenten</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

1223
docs/de/designers/language-builtin-functions/language-function-section.xml
View File

File diff suppressed because it is too large Load Diff

97
docs/de/designers/language-builtin-functions/language-function-strip.xml
View File

@@ -1,56 +1,67 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: andreas Status: ready -->
<sect1 id="language.function.strip">
<title>strip</title>
<para>
Webdesigner haben oft das Problem, dass Leerzeichen und Zeilenumbr&uuml;che
die Ausgabe des erzeugten HTML im Browser beeinflussen. Oft werden deshalb alle
Tags aufeinanderfolgend im Template notiert, was aber zu einer schlechten
Lesbarkeit f&uuml;hrt.
</para>
<para>
Aus dem Inhalt zwischen den {strip}{/strip}-Tags werden alle Leerzeichen und
Zeilenumbr&uuml;che entfernt. So k&ouml;nnen Sie Ihre Templates lesbar
halten, ohne sich Sorgen um die Leerzeichen zu machen.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
{strip}{/strip} &auml;ndert nicht den Inhalt einer Template-Variablen.
Daf&uuml;r gibt es den <link linkend="language.modifier.strip">strip Modifikator</link>.
</para>
</note>
<example>
<title>strip tags</title>
<programlisting>
<!-- EN-Revision: 1.6 Maintainer: andreas Status: ready -->
<sect1 id="language.function.strip">
<title>strip</title>
<para>
Webdesigner haben oft das Problem, dass Leerzeichen und
Zeilenumbr<62>che die Ausgabe des erzeugten HTML im Browser
beeinflussen. Oft werden deshalb alle Tags aufeinanderfolgend im
Template notiert, was aber zu einer schlechten Lesbarkeit f<EFBFBD>hrt.
</para>
<para>
Aus dem Inhalt zwischen den {strip}{/strip}-Tags werden alle
Leerzeichen und Zeilenumbr<EFBFBD>che entfernt. So k<EFBFBD>nnen Sie Ihre
Templates lesbar halten, ohne sich Sorgen um die Leerzeichen zu
machen.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
{strip}{/strip} <20>ndert nicht den Inhalt einer Template-Variablen.
Daf<61>r gibt es den <link linkend="language.modifier.strip">strip
Modifikator</link>.
</para>
</note>
<example>
<title>strip tags</title>
<programlisting>
<![CDATA[
{* der folgende Inhalt wird in einer Zeile ausgegeben *}
{strip}
<table border=0>
<tr>
<td>
<A HREF="{$url}">
<font color="red">Das ist ein Test.</font>
</A>
</td>
</tr>
<tr>
<td>
<a HREF="{$url}">
<font color="red">Das ist ein Test.</font>
</a>
</td>
</tr>
</table>
{/strip}
AUSGABE:
<table border=0><tr><td><A HREF="http://my.domain.com"><font color="red">Das ist ein Test.</font></A></td></tr></table></programlisting>
]]>
</programlisting>
</example>
<para>
Achtung: im obigen Beispiel beginnen und enden alle Zeilen mit HTML-Tags.
Falls Sie Abschnitte haben, die nur Text enthalten, werden diese ebenfalls
zusammengeschlossen. Das kann zu unerw&uuml;nschten Resultaten f&uuml;hren.
</para>
</programlisting>
<para>
Ausgebe des obigen Beispiels:
</para>
<screen>
<![CDATA[
<table border=0><tr><td><A HREF="http://my.domain.com"><font color="red">Das ist ein Test.</font></A></td></tr></table>
]]>
</screen>
</example>
<para>
Achtung: im obigen Beispiel beginnen und enden alle Zeilen mit
HTML-Tags. Falls Sie Abschnitte haben, die nur Text enthalten,
werden diese ebenfalls zusammengeschlossen. Das kann zu
unerw<72>nschten Resultaten f<>hren.
</para>
<para>
Siehe auch <link linkend="language.modifier.strip">strip-Modifikator
(Zeichenkette strippen)</link>
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml