cvs: smarty /docs/en/appendixes tips.xml /docs/en/designers/language-basic-syntax language-syntax-quotes.xml language-syntax-variables.xml /docs/en/designers/language-builtin-functions language-function-config-load.xml language-function-foreach.xml language-function-include.xml language-function-php.xml /docs/en/designers/language-custom-functions language-function-html-select-date.xml /docs/en/designers/language-modifiers language-modifier-count-characters.xml language-modifier-count-paragraphs.xml language-modifier-count-sentences.xml language-modifier-count-words.xml language-modifier-date-format.xml language-modifier-default.xml language-modifier-escape.xml language-modifier-nl2br.xml language-modifier-wordwrap.xml /docs/en/designers/language-variables language-config-variables.xml language-variables-smarty.xml
"Nuno Lopes" <[email protected]>
| Newsgroups | gmane.comp.php.cvs.smarty |
|---|---|
| Message-ID | <cvsnlopess1115740872@cvsserver> |
nlopess Tue May 10 12:01:13 2005 EDT
Modified files:
/smarty/docs/en/appendixes tips.xml
/smarty/docs/en/designers/language-basic-syntax
language-syntax-quotes.xml
language-syntax-variables.xml
/smarty/docs/en/designers/language-builtin-functions
language-function-config-load.xml
language-function-foreach.xml
language-function-include.xml
language-function-php.xml
/smarty/docs/en/designers/language-custom-functions
language-function-html-select-date.xml
/smarty/docs/en/designers/language-modifiers
language-modifier-count-characters.xml
language-modifier-count-paragraphs.xml
language-modifier-count-sentences.xml
language-modifier-count-words.xml
language-modifier-date-format.xml
language-modifier-default.xml
language-modifier-escape.xml
language-modifier-nl2br.xml
language-modifier-wordwrap.xml
/smarty/docs/en/designers/language-variables
language-config-variables.xml
language-variables-smarty.xml
Log:
commit Peter Morgan's patch to add more references/aka see also
some WS
--
Smarty CVS Mailing List (http://cvs.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
nlopess-20050510120113.txt
(text/plain, 46.2 KB)
http://cvs.php.net/diff.php/smarty/docs/en/appendixes/tips.xml?r1=1.5&r2=1.6&ty=u
Index: smarty/docs/en/appendixes/tips.xml
diff -u smarty/docs/en/appendixes/tips.xml:1.5 smarty/docs/en/appendixes/tips.xml:1.6
--- smarty/docs/en/appendixes/tips.xml:1.5 Sat Nov 20 21:04:01 2004
+++ smarty/docs/en/appendixes/tips.xml Tue May 10 12:01:04 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<chapter id="tips">
<title>Tips & Tricks</title>
<para>
@@ -9,7 +9,7 @@
<para>
There may be times when you want to print a default value for an empty
variable instead of printing nothing, such as printing "&nbsp;" so that
- table backgrounds work properly. Many would use an {if} statement to
+ table backgrounds work properly. Many would use an <link linkend="language.function.if">{if}</link> statement to
handle this, but there is a shorthand way with Smarty, using the
<emphasis>default</emphasis> variable modifier.
</para>
@@ -32,6 +32,7 @@
]]>
</programlisting>
</example>
+ <para>See also <link linkend="language.modifier.default">default</link> and <link linkend="tips.default.var.handling">Default Variable Handling</link></para>
</sect1>
<sect1 id="tips.default.var.handling">
@@ -54,6 +55,7 @@
]]>
</programlisting>
</example>
+ <para>See also <link linkend="language.modifier.default">default</link> and <link linkend="tips.blank.var.handling">Blank Variable Handling</link></para>
</sect1>
<sect1 id="tips.passing.vars">
<title>Passing variable title to header template</title>
@@ -123,7 +125,7 @@
<note>
<para>
As of Smarty 1.4.0, you can pass dates to Smarty as unix
- timestamps, mysql timestamps, or any date parsable by strtotime().
+ timestamps, mysql timestamps, or any date parsable by <ulink url="&url.php-manual;strtotime">strtotime()</ulink>.
</para>
</note>
<example>
@@ -163,7 +165,7 @@
</programlisting>
</example>
<para>
- When using {html_select_date} in a template, The programmer will most
+ When using <link linkend="language.function.html.select.date">{html_select_date}</link> in a template, The programmer will most
likely want to convert the output from the form back into timestamp
format. Here is a function to help you with that.
</para>
@@ -267,7 +269,7 @@
Traditionally, programming templates into your applications goes as
follows: First, you accumulate your variables within your PHP
application, (maybe with database queries.) Then, you instantiate your
- Smarty object, assign the variables and display the template. So lets
+ Smarty object, <link linkend="api.assign">assign</link> the variables and <link linkend="api.display">display</link> the template. So lets
say for example we have a stock ticker on our template. We would
collect the stock data in our application, then assign these variables
in the template and display it. Now wouldn't it be nice if you could
@@ -315,6 +317,7 @@
]]>
</programlisting>
</example>
+ <para>See also <link linkend="language.function.include.php">{include_php}</link>, <link linkend="language.function.include">{include}</link> and <link linkend="language.function.php">{php}</link></para>
</sect1>
<sect1 id="tips.obfuscating.email">
<title>Obfuscating E-mail Addresses</title>
@@ -343,6 +346,7 @@
e-mail collector to decode these values, but not likely.
</para>
</note>
+ <para>See also <link linkend="language.modifier.escape">escape</link></para>
</sect1>
</chapter>
<!-- Keep this comment at the end of the file
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-basic-syntax/language-syntax-quotes.xml?r1=1.3&r2=1.4&ty=u
Index: smarty/docs/en/designers/language-basic-syntax/language-syntax-quotes.xml
diff -u smarty/docs/en/designers/language-basic-syntax/language-syntax-quotes.xml:1.3 smarty/docs/en/designers/language-basic-syntax/language-syntax-quotes.xml:1.4
--- smarty/docs/en/designers/language-basic-syntax/language-syntax-quotes.xml:1.3 Mon Dec 20 14:52:32 2004
+++ smarty/docs/en/designers/language-basic-syntax/language-syntax-quotes.xml Tue May 10 12:01:07 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<sect1 id="language.syntax.quotes">
<title>Embedding Vars in Double Quotes</title>
<para>
@@ -28,6 +28,7 @@
]]>
</programlisting>
</example>
+ <para>See also <link linkend="language.modifier.escape">escape</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-basic-syntax/language-syntax-variables.xml?r1=1.3&r2=1.4&ty=u
Index: smarty/docs/en/designers/language-basic-syntax/language-syntax-variables.xml
diff -u smarty/docs/en/designers/language-basic-syntax/language-syntax-variables.xml:1.3 smarty/docs/en/designers/language-basic-syntax/language-syntax-variables.xml:1.4
--- smarty/docs/en/designers/language-basic-syntax/language-syntax-variables.xml:1.3 Tue Dec 14 15:25:44 2004
+++ smarty/docs/en/designers/language-basic-syntax/language-syntax-variables.xml Tue May 10 12:01:07 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<sect1 id="language.syntax.variables">
<title>Variables</title>
<para>
@@ -36,6 +36,8 @@
]]>
</programlisting>
</example>
+ <para>See also <link linkend="language.variables.smarty">$smarty reserved variables</link>
+and <link linkend="language.config.variables">Config Variables</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-builtin-functions/language-function-config-load.xml?r1=1.5&r2=1.6&ty=u
Index: smarty/docs/en/designers/language-builtin-functions/language-function-config-load.xml
diff -u smarty/docs/en/designers/language-builtin-functions/language-function-config-load.xml:1.5 smarty/docs/en/designers/language-builtin-functions/language-function-config-load.xml:1.6
--- smarty/docs/en/designers/language-builtin-functions/language-function-config-load.xml:1.5 Sun May 8 15:47:01 2005
+++ smarty/docs/en/designers/language-builtin-functions/language-function-config-load.xml Tue May 10 12:01:07 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<sect1 id="language.function.config.load">
<title>config_load</title>
<informaltable frame="all">
@@ -127,7 +127,7 @@
<para>
See also <link linkend="config.files">Config Files</link> and
- <link linkend="language.function.config.load">Config Load</link>.
+ <link linkend="language.config.variables">Config variables</link>.
</para>
</sect1>
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-builtin-functions/language-function-foreach.xml?r1=1.3&r2=1.4&ty=u
Index: smarty/docs/en/designers/language-builtin-functions/language-function-foreach.xml
diff -u smarty/docs/en/designers/language-builtin-functions/language-function-foreach.xml:1.3 smarty/docs/en/designers/language-builtin-functions/language-function-foreach.xml:1.4
--- smarty/docs/en/designers/language-builtin-functions/language-function-foreach.xml:1.3 Tue May 10 07:42:38 2005
+++ smarty/docs/en/designers/language-builtin-functions/language-function-foreach.xml Tue May 10 12:01:08 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<sect1 id="language.function.foreach">
<title>foreach,foreachelse</title>
<informaltable frame="all">
@@ -54,8 +54,10 @@
</informaltable>
<para>
<emphasis>foreach</emphasis> loops are an alternative to
- <emphasis>section</emphasis> loops. <emphasis>foreach</emphasis> is
- used to loop over a single associative array. The syntax for
+ <link
+ linkend="language.function.section"><emphasis>section</emphasis></link>
+ loops. <emphasis>foreach</emphasis> is used to loop over a single
+ associative array. The syntax for
<emphasis>foreach</emphasis> is much easier than
<emphasis>section</emphasis>, but as a tradeoff it can only be used
for a single array. <emphasis>foreach</emphasis> tags must be
@@ -178,6 +180,10 @@
<emphasis>total</emphasis> is used to display the number of iterations that this foreach
will loop. This can be used inside or after the foreach.
</para>
+ <para>
+ See also <link linkend="language.function.section">{section}</link> and
+ <link linkend="language.variables.smarty.loops">$smarty.foreach</link>.
+ </para>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
@@ -199,4 +205,4 @@
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-builtin-functions/language-function-include.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/en/designers/language-builtin-functions/language-function-include.xml
diff -u smarty/docs/en/designers/language-builtin-functions/language-function-include.xml:1.2 smarty/docs/en/designers/language-builtin-functions/language-function-include.xml:1.3
--- smarty/docs/en/designers/language-builtin-functions/language-function-include.xml:1.2 Sat Nov 20 21:04:01 2004
+++ smarty/docs/en/designers/language-builtin-functions/language-function-include.xml Tue May 10 12:01:08 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<sect1 id="language.function.include">
<title>include</title>
<informaltable frame="all">
@@ -84,7 +84,7 @@
<para>
Use the syntax for <link
linkend="template.resources">template resources</link> to
- include files outside of the $template_dir directory.
+ include files outside of the <link linkend="variable.template.dir">$template_dir</link> directory.
</para>
<example>
<title>function include template resource examples</title>
@@ -101,6 +101,7 @@
{* include from template resource named "db" *}
{include file="db:header.tpl"}</programlisting>
</example>
+<para>See also <link linkend="language.function.include.php">{include_php}</link>, <link linkend="language.function.php">{php}</link> <link linkend="template.resources">Template Resources</link> and <link linkend="tips.componentized.templates">Componentized Templates</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-builtin-functions/language-function-php.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/en/designers/language-builtin-functions/language-function-php.xml
diff -u smarty/docs/en/designers/language-builtin-functions/language-function-php.xml:1.1 smarty/docs/en/designers/language-builtin-functions/language-function-php.xml:1.2
--- smarty/docs/en/designers/language-builtin-functions/language-function-php.xml:1.1 Tue Apr 13 04:40:21 2004
+++ smarty/docs/en/designers/language-builtin-functions/language-function-php.xml Tue May 10 12:01:08 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<sect1 id="language.function.php">
<title>php</title>
<para>
@@ -17,6 +17,7 @@
include("/path/to/display_weather.php");
{/php}</programlisting>
</example>
+ <para>See also <link linkend="language.function.include.php">{include_php}</link>, <link linkend="language.function.include">{include}</link> and <link linkend="tips.componentized.templates">Componentized Templates</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-custom-functions/language-function-html-select-date.xml?r1=1.4&r2=1.5&ty=u
Index: smarty/docs/en/designers/language-custom-functions/language-function-html-select-date.xml
diff -u smarty/docs/en/designers/language-custom-functions/language-function-html-select-date.xml:1.4 smarty/docs/en/designers/language-custom-functions/language-function-html-select-date.xml:1.5
--- smarty/docs/en/designers/language-custom-functions/language-function-html-select-date.xml:1.4 Mon Nov 1 13:14:22 2004
+++ smarty/docs/en/designers/language-custom-functions/language-function-html-select-date.xml Tue May 10 12:01:08 2005
@@ -1,247 +1,241 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
- <sect1 id="language.function.html.select.date">
- <title>html_select_date</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>Attribute Name</entry>
- <entry>Type</entry>
- <entry>Required</entry>
- <entry>Default</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>prefix</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>Date_</entry>
- <entry>what to prefix the var name with</entry>
- </row>
- <row>
- <entry>time</entry>
- <entry>timestamp/YYYY-MM-DD</entry>
- <entry>No</entry>
- <entry>current time in unix timestamp or YYYY-MM-DD
- format</entry>
- <entry>what date/time to use</entry>
- </row>
- <row>
- <entry>start_year</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>current year</entry>
- <entry>the first year in the dropdown, either
- year number, or relative to current year (+/- N)</entry>
- </row>
- <row>
- <entry>end_year</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>same as start_year</entry>
- <entry>the last year in the dropdown, either
- year number, or relative to current year (+/- N)</entry>
- </row>
- <row>
- <entry>display_days</entry>
- <entry>boolean</entry>
- <entry>No</entry>
- <entry>true</entry>
- <entry>whether to display days or not</entry>
- </row>
- <row>
- <entry>display_months</entry>
- <entry>boolean</entry>
- <entry>No</entry>
- <entry>true</entry>
- <entry>whether to display months or not</entry>
- </row>
- <row>
- <entry>display_years</entry>
- <entry>boolean</entry>
- <entry>No</entry>
- <entry>true</entry>
- <entry>whether to display years or not</entry>
- </row>
- <row>
- <entry>month_format</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>%B</entry>
- <entry>what format the month should be in (strftime)</entry>
- </row>
- <row>
- <entry>day_format</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>%02d</entry>
- <entry>what format the day output should be in (sprintf)</entry>
- </row>
- <row>
- <entry>day_value_format</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>%d</entry>
- <entry>what format the day value should be in (sprintf)</entry>
- </row>
- <row>
- <entry>year_as_text</entry>
- <entry>boolean</entry>
- <entry>No</entry>
- <entry>false</entry>
- <entry>whether or not to display the year as text</entry>
- </row>
- <row>
- <entry>reverse_years</entry>
- <entry>boolean</entry>
- <entry>No</entry>
- <entry>false</entry>
- <entry>display years in reverse order</entry>
- </row>
- <row>
- <entry>field_array</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>
- if a name is given, the select boxes will be drawn
- such that the results will be returned to PHP in the
- form of name[Day], name[Year], name[Month].
- </entry>
- </row>
- <row>
- <entry>day_size</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>adds size attribute to select tag if given</entry>
- </row>
- <row>
- <entry>month_size</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>adds size attribute to select tag if given</entry>
- </row>
- <row>
- <entry>year_size</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>adds size attribute to select tag if given</entry>
- </row>
- <row>
- <entry>all_extra</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>adds extra attributes to all select/input tags if
- given</entry>
- </row>
- <row>
- <entry>day_extra</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>adds extra attributes to select/input tags if
- given</entry>
- </row>
- <row>
- <entry>month_extra</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>adds extra attributes to select/input tags if
- given</entry>
- </row>
- <row>
- <entry>year_extra</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>adds extra attributes to select/input tags if
- given</entry>
- </row>
- <row>
- <entry>field_order</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>MDY</entry>
- <entry>the order in which to display the fields</entry>
- </row>
- <row>
- <entry>field_separator</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>\n</entry>
- <entry>string printed between different fields</entry>
- </row>
- <row>
- <entry>month_value_format</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>%m</entry>
- <entry>strftime format of the month values, default is
- %m for month numbers.</entry>
- </row>
- <row>
- <entry>year_empty</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>If supplied then the first element of the year's select-box has this
- value as it's label and "" as it's value. This is useful to make the
- select-box read "Please select a year" for example.
-
- Note that you can use values like "-MM-DD" as time-attribute to indicate
- an unselected year.</entry>
- </row>
- <row>
- <entry>month_empty</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>If supplied then the first element of the month's select-box has this
- value as it's label and "" as it's value. .
- Note that you can use values like "YYYY--DD" as time-attribute to indicate
- an unselected month.</entry>
- </row>
- <row>
- <entry>day_empty</entry>
- <entry>string</entry>
- <entry>No</entry>
- <entry>null</entry>
- <entry>If supplied then the first element of the day's select-box has this
- value as it's label and "" as it's value.
- Note that you can use values like "YYYY-MM-" as time-attribute to indicate
- an unselected day.</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- <para>
- html_select_date is a custom function that creates date dropdowns
- for you. It can display any or all of year, month, and day.
- </para>
-<example>
-<title>html_select_date</title>
-<programlisting>
+<!-- $Revision: 1.5 $ -->
+<sect1 id="language.function.html.select.date">
+ <title>html_select_date</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>Attribute Name</entry>
+ <entry>Type</entry>
+ <entry>Required</entry>
+ <entry>Default</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>prefix</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>Date_</entry>
+ <entry>what to prefix the var name with</entry>
+ </row>
+ <row>
+ <entry>time</entry>
+ <entry>timestamp/YYYY-MM-DD</entry>
+ <entry>No</entry>
+ <entry>current time in unix timestamp or YYYY-MM-DD format</entry>
+ <entry>what date/time to use</entry>
+ </row>
+ <row>
+ <entry>start_year</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>current year</entry>
+ <entry>the first year in the dropdown, either
+ year number, or relative to current year (+/- N)</entry>
+ </row>
+ <row>
+ <entry>end_year</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>same as start_year</entry>
+ <entry>the last year in the dropdown, either
+ year number, or relative to current year (+/- N)</entry>
+ </row>
+ <row>
+ <entry>display_days</entry>
+ <entry>boolean</entry>
+ <entry>No</entry>
+ <entry>true</entry>
+ <entry>whether to display days or not</entry>
+ </row>
+ <row>
+ <entry>display_months</entry>
+ <entry>boolean</entry>
+ <entry>No</entry>
+ <entry>true</entry>
+ <entry>whether to display months or not</entry>
+ </row>
+ <row>
+ <entry>display_years</entry>
+ <entry>boolean</entry>
+ <entry>No</entry>
+ <entry>true</entry>
+ <entry>whether to display years or not</entry>
+ </row>
+ <row>
+ <entry>month_format</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>%B</entry>
+ <entry>what format the month should be in (strftime)</entry>
+ </row>
+ <row>
+ <entry>day_format</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>%02d</entry>
+ <entry>what format the day output should be in (sprintf)</entry>
+ </row>
+ <row>
+ <entry>day_value_format</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>%d</entry>
+ <entry>what format the day value should be in (sprintf)</entry>
+ </row>
+ <row>
+ <entry>year_as_text</entry>
+ <entry>boolean</entry>
+ <entry>No</entry>
+ <entry>false</entry>
+ <entry>whether or not to display the year as text</entry>
+ </row>
+ <row>
+ <entry>reverse_years</entry>
+ <entry>boolean</entry>
+ <entry>No</entry>
+ <entry>false</entry>
+ <entry>display years in reverse order</entry>
+ </row>
+ <row>
+ <entry>field_array</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>
+ if a name is given, the select boxes will be drawn
+ such that the results will be returned to PHP in the
+ form of name[Day], name[Year], name[Month].
+ </entry>
+ </row>
+ <row>
+ <entry>day_size</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>adds size attribute to select tag if given</entry>
+ </row>
+ <row>
+ <entry>month_size</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>adds size attribute to select tag if given</entry>
+ </row>
+ <row>
+ <entry>year_size</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>adds size attribute to select tag if given</entry>
+ </row>
+ <row>
+ <entry>all_extra</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>adds extra attributes to all select/input tags if given</entry>
+ </row>
+ <row>
+ <entry>day_extra</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>adds extra attributes to select/input tags if given</entry>
+ </row>
+ <row>
+ <entry>month_extra</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>adds extra attributes to select/input tags if given</entry>
+ </row>
+ <row>
+ <entry>year_extra</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>adds extra attributes to select/input tags if given</entry>
+ </row>
+ <row>
+ <entry>field_order</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>MDY</entry>
+ <entry>the order in which to display the fields</entry>
+ </row>
+ <row>
+ <entry>field_separator</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>\n</entry>
+ <entry>string printed between different fields</entry>
+ </row>
+ <row>
+ <entry>month_value_format</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>%m</entry>
+ <entry>strftime format of the month values, default is
+ %m for month numbers.</entry>
+ </row>
+ <row>
+ <entry>year_empty</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>If supplied then the first element of the year's select-box has this
+ value as it's label and "" as it's value. This is useful to make the
+ select-box read "Please select a year" for example.
+ Note that you can use values like "-MM-DD" as time-attribute to indicate
+ an unselected year.</entry>
+ </row>
+ <row>
+ <entry>month_empty</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>If supplied then the first element of the month's select-box has this
+ value as it's label and "" as it's value. .
+ Note that you can use values like "YYYY--DD" as time-attribute to indicate
+ an unselected month.</entry>
+ </row>
+ <row>
+ <entry>day_empty</entry>
+ <entry>string</entry>
+ <entry>No</entry>
+ <entry>null</entry>
+ <entry>If supplied then the first element of the day's select-box has this
+ value as it's label and "" as it's value.
+ Note that you can use values like "YYYY-MM-" as time-attribute to indicate
+ an unselected day.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>
+ html_select_date is a custom function that creates date dropdowns
+ for you. It can display any or all of year, month, and day.
+ </para>
+ <example>
+ <title>html_select_date</title>
+ <programlisting>
<![CDATA[
{html_select_date}
]]>
-</programlisting>
-<para>
-This will output:
-</para>
-<screen>
+ </programlisting>
+ <para>
+ This will output:
+ </para>
+ <screen>
<![CDATA[
<select name="Date_Month">
<option value="1">January</option>
@@ -294,21 +288,21 @@
<option value="2001" selected="selected">2001</option>
</select>
]]>
-</screen>
-</example>
+ </screen>
+ </example>
-<example>
-<title>html_select_date</title>
-<programlisting>
+ <example>
+ <title>html_select_date</title>
+ <programlisting>
<![CDATA[
{* start and end year can be relative to current year *}
{html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false}
]]>
-</programlisting>
-<para>
-This will output: (current year is 2000)
-</para>
-<screen>
+ </programlisting>
+ <para>
+ This will output: (current year is 2000)
+ </para>
+ <screen>
<![CDATA[
<select name="StartDateMonth">
<option value="1">January</option>
@@ -334,9 +328,16 @@
<option value="2001">2001</option>
</select>
]]>
-</screen>
-</example>
+ </screen>
+ </example>
+ <para>
+ See also <link linkend="language.function.html.select.time">html_select_time</link>,
+ <link linkend="language.modifier.date.format">date_format</link>,
+ <link linkend="language.variables.smarty.now">$smarty.now</link>
+ and <link linkend="tips.dates">date tips</link>.
+ </para>
</sect1>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -356,4 +357,4 @@
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-count-characters.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-count-characters.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-count-characters.xml:1.2 smarty/docs/en/designers/language-modifiers/language-modifier-count-characters.xml:1.3
--- smarty/docs/en/designers/language-modifiers/language-modifier-count-characters.xml:1.2 Sun May 8 15:47:01 2005
+++ smarty/docs/en/designers/language-modifiers/language-modifier-count-characters.xml Tue May 10 12:01:09 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<sect1 id="language.modifier.count.characters">
<title>count_characters</title>
<informaltable frame="all">
@@ -67,8 +67,8 @@
]]>
</screen>
</example>
- <para>See also <link linkend="language.modifier.count.paragraphs">count_paragraphs</link>
- <link linkend="language.modifier.count.sentences">count_sentences</link>
+ <para>See also <link linkend="language.modifier.count.paragraphs">count_paragraphs</link>,
+ <link linkend="language.modifier.count.sentences">count_sentences</link> and
<link linkend="language.modifier.count.words">count_words</link>
</para>
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml:1.2 smarty/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml:1.3
--- smarty/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml:1.2 Sun May 8 15:47:01 2005
+++ smarty/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml Tue May 10 12:01:09 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<sect1 id="language.modifier.count.paragraphs">
<title>count_paragraphs</title>
<para>
@@ -38,8 +38,8 @@
]]>
</screen>
</example>
- <para>See also <link linkend="language.modifier.count.characters">count_characters</link>
- <link linkend="language.modifier.count.sentences">count_sentences</link>
+ <para>See also <link linkend="language.modifier.count.characters">count_characters</link>,
+ <link linkend="language.modifier.count.sentences">count_sentences</link> and
<link linkend="language.modifier.count.words">count_words</link>
</para>
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml:1.2 smarty/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml:1.3
--- smarty/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml:1.2 Sun May 8 15:47:01 2005
+++ smarty/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml Tue May 10 12:01:09 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<sect1 id="language.modifier.count.sentences">
<title>count_sentences</title>
<para>
@@ -37,8 +37,8 @@
]]>
</screen>
</example>
- <para>See also <link linkend="language.modifier.count.characters">count_characters</link>
- <link linkend="language.modifier.count.paragraphs">count_paragraphs</link>
+ <para>See also <link linkend="language.modifier.count.characters">count_characters</link>,
+ <link linkend="language.modifier.count.paragraphs">count_paragraphs</link> and
<link linkend="language.modifier.count.words">count_words</link>
</para>
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-count-words.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-count-words.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-count-words.xml:1.2 smarty/docs/en/designers/language-modifiers/language-modifier-count-words.xml:1.3
--- smarty/docs/en/designers/language-modifiers/language-modifier-count-words.xml:1.2 Sun May 8 15:47:01 2005
+++ smarty/docs/en/designers/language-modifiers/language-modifier-count-words.xml Tue May 10 12:01:10 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<sect1 id="language.modifier.count.words">
<title>count_words</title>
<para>
@@ -37,8 +37,8 @@
]]>
</screen>
</example>
- <para>See also <link linkend="language.modifier.count.characters">count_characters</link>
- <link linkend="language.modifier.count.paragraphs">count_paragraphs</link>
+ <para>See also <link linkend="language.modifier.count.characters">count_characters</link>,
+ <link linkend="language.modifier.count.paragraphs">count_paragraphs</link> and
<link linkend="language.modifier.count.sentences">count_sentences</link>
</para>
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-date-format.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-date-format.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-date-format.xml:1.2 smarty/docs/en/designers/language-modifiers/language-modifier-date-format.xml:1.3
--- smarty/docs/en/designers/language-modifiers/language-modifier-date-format.xml:1.2 Sun May 8 15:47:01 2005
+++ smarty/docs/en/designers/language-modifiers/language-modifier-date-format.xml Tue May 10 12:01:11 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<sect1 id="language.modifier.date.format">
<title>date_format</title>
<informaltable frame="all">
@@ -37,9 +37,9 @@
</tgroup>
</informaltable>
<para>
- This formats a date and time into the given strftime() format.
+ This formats a date and time into the given <ulink url="&url.php-manual;strftime">strftime()</ulink> format.
Dates can be passed to Smarty as unix timestamps, mysql timestamps
- or any string made up of month day year (parsable by strtotime).
+ or any string made up of month day year (parsable by <ulink url="&url.php-manual;strtotime">strtotime</ulink>).
Designers can then use date_format to have complete control of the
formatting of the date. If the date passed to date_format is empty
and a second parameter is passed, that will be used as the date to
@@ -211,6 +211,7 @@
</para>
</note>
</para>
+ <para>See also <link linkend="language.variables.smarty.now">$smarty.now</link>, <link linkend="language.function.html.select.date">{html_select_date}</link> and <link linkend="tips.dates">date tips</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-default.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-default.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-default.xml:1.1 smarty/docs/en/designers/language-modifiers/language-modifier-default.xml:1.2
--- smarty/docs/en/designers/language-modifiers/language-modifier-default.xml:1.1 Tue Apr 13 04:40:22 2004
+++ smarty/docs/en/designers/language-modifiers/language-modifier-default.xml Tue May 10 12:01:11 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<sect1 id="language.modifier.default">
<title>default</title>
<informaltable frame="all">
@@ -67,6 +67,8 @@
]]>
</screen>
</example>
+ <para>See also <link linkend="tips.default.var.handling">Default Variable Handling</link> and <link linkend="tips.blank.var.handling">Blank Variable Handling</link></para>
+
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-escape.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-escape.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-escape.xml:1.2 smarty/docs/en/designers/language-modifiers/language-modifier-escape.xml:1.3
--- smarty/docs/en/designers/language-modifiers/language-modifier-escape.xml:1.2 Sun May 8 15:52:51 2005
+++ smarty/docs/en/designers/language-modifiers/language-modifier-escape.xml Tue May 10 12:01:11 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<sect1 id="language.modifier.escape">
<title>escape</title>
<informaltable frame="all">
@@ -76,12 +76,12 @@
'Stiff Opposition Expected to Casketless Funeral Plan'
%27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27
\'Stiff Opposition Expected to Casketless Funeral Plan\'
-<a href="mailto:%62%6f%62%40%6d%65%2e%6e%65%74">bob@me.net</a>
+<a href="mailto:%62%6f%..snip..%65%74">bob..snip..et</a>
]]>
</screen>
</example>
<para>
- See also <link linkend="language.escaping">Escaping Smarty Parsing</link>.
+ See also <link linkend="language.escaping">Escaping Smarty Parsing</link> and <link linkend="tips.obfuscating.email">Obfuscating E-mail Addresses</link>.
</para>
</sect1>
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-nl2br.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-nl2br.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-nl2br.xml:1.1 smarty/docs/en/designers/language-modifiers/language-modifier-nl2br.xml:1.2
--- smarty/docs/en/designers/language-modifiers/language-modifier-nl2br.xml:1.1 Tue Apr 13 04:40:22 2004
+++ smarty/docs/en/designers/language-modifiers/language-modifier-nl2br.xml Tue May 10 12:01:11 2005
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<sect1 id="language.modifier.nl2br">
<title>nl2br</title>
<para>
All linebreaks will be converted to <br /> tags in the given
- variable. This is equivalent to the PHP nl2br() function.
+ variable. This is equivalent to the PHP <ulink url="&url.php-manual;nl2br">nl2br()</ulink> function.
</para>
<example>
<title>nl2br</title>
@@ -36,6 +36,7 @@
]]>
</screen>
</example>
+<para>See also <link linkend="language.modifier.wordwrap">word_wrap</link>, <link linkend="language.modifier.count.paragraphs">count_paragraphs</link> and <link linkend="language.modifier.count.sentences">count_sentences</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-modifiers/language-modifier-wordwrap.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/en/designers/language-modifiers/language-modifier-wordwrap.xml
diff -u smarty/docs/en/designers/language-modifiers/language-modifier-wordwrap.xml:1.1 smarty/docs/en/designers/language-modifiers/language-modifier-wordwrap.xml:1.2
--- smarty/docs/en/designers/language-modifiers/language-modifier-wordwrap.xml:1.1 Tue Apr 13 04:40:22 2004
+++ smarty/docs/en/designers/language-modifiers/language-modifier-wordwrap.xml Tue May 10 12:01:11 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<sect1 id="language.modifier.wordwrap">
<title>wordwrap</title>
<informaltable frame="all">
@@ -108,6 +108,7 @@
]]>
</screen>
</example>
+<para>See also <link linkend="language.modifier.nl2br">nl2br</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-variables/language-config-variables.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/en/designers/language-variables/language-config-variables.xml
diff -u smarty/docs/en/designers/language-variables/language-config-variables.xml:1.1 smarty/docs/en/designers/language-variables/language-config-variables.xml:1.2
--- smarty/docs/en/designers/language-variables/language-config-variables.xml:1.1 Tue Apr 13 04:40:22 2004
+++ smarty/docs/en/designers/language-variables/language-config-variables.xml Tue May 10 12:01:12 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<sect1 id="language.config.variables">
<title>Variables loaded from config files</title>
<para>
@@ -87,8 +87,9 @@
<para>
Config file variables cannot be used until
after they are loaded in from a config file. This procedure is
- explained later in this document under <command>config_load</command>.
+ explained later in this document under <link linkend="api.config.load"><command>config_load</command></link>.
</para>
+ <para>See also <link linkend="language.syntax.variables">Variables</link> and <link linkend="language.variables.smarty">$smarty reserved variables</link></para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/diff.php/smarty/docs/en/designers/language-variables/language-variables-smarty.xml?r1=1.5&r2=1.6&ty=u
Index: smarty/docs/en/designers/language-variables/language-variables-smarty.xml
diff -u smarty/docs/en/designers/language-variables/language-variables-smarty.xml:1.5 smarty/docs/en/designers/language-variables/language-variables-smarty.xml:1.6
--- smarty/docs/en/designers/language-variables/language-variables-smarty.xml:1.5 Sun May 8 15:47:01 2005
+++ smarty/docs/en/designers/language-variables/language-variables-smarty.xml Tue May 10 12:01:12 2005
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<sect1 id="language.variables.smarty">
- <title>{$smarty} reserved variable</title>
+ <title>{$smarty} reserved variables</title>
<para>
The reserved {$smarty} variable can be used to access several
special template variables. The full list of them follows.
@@ -56,7 +56,7 @@
The current timestamp can be accessed with {$smarty.now}. The
number reflects the number of seconds passed since the so-called
Epoch (January 1, 1970) and can be passed directly to
- date_format modifier for display purposes.
+ <link linkend="language.modifier.date.format">date_format</link> modifier for display purposes.
</para>
<example>
<title>using {$smarty.now}</title>
@@ -137,6 +137,7 @@
This variable is used for printing the right-delimiter value literally.
See also <link linkend="language.function.ldelim">{ldelim},{rdelim}</link>.
</para>
+ <para>See also <link linkend="language.syntax.variables">Variables</link> and <link linkend="language.config.variables">Config Variables</link></para>
</sect2>
</sect1>