\documentclass{article}
\usepackage{ulem}
\usepackage{graphicx}
\usepackage{hyperref}
\pagestyle{headings}
\begin{document}
\section{Documentation for the Horde\_Template:: package present in Horde 3.2}
\subsection{Setup}
The absolute minimum to get in the required functions for Horde\_Template to work:

<pre><code class="language-php">require "Horde/String.php";
require "Horde/Util.php";
require "Horde/Template.php";
</code></pre>
(You're probably better off installing Horde's \texttt{base.php} or \texttt{core.php} - although it will load the whole Horde core - rather than just the templating engine.)

To set up the template object:

<pre><code class="language-php">\$template = new Horde\_Template([\$basepath]);
</code></pre>
If you want to fetch templates from a different base directory, then specify that directory in the optional \texttt{\$basepath} argument.

You can proceed with feeding variables into the object (see below for examples).

Once you're done feeding in variables, you need to get your PHP code to output the resulting HTML, which you can do in either of the following ways.

If your template is in a local string, you can do the following:

<pre><code class="language-php">echo \$template->parse(\$template\_code);
</code></pre>
If your template is in a separate file, you should run this command:

<pre><code class="language-php">echo \$template->fetch(\$template\_file);
</code></pre>
\textbf{Note:} If you make the PHP script do any output of its own, outside of the Horde\_Template:: system, it will appear in the output positioned relative to the position of the above \texttt{fetch()} call in the code.

\subsection{Simple Variables}
PHP:

<pre><code class="language-php">// If in php-land you have a variable like:
//   \$foo = 'bar';

// Set it into your template using:
\$template->set('foo', \$foo);
</code></pre>
Template:

<pre><code><html><body>
foo value of <tag:foo />
</body></html>
</code></pre>
** Note:** The \texttt{<tag:... />} has to be exactly like above, with one space between the foo and />. Any other variation and the value will not be parsed. Unparsed tags are silently removed from the output string.

\subsection{Arrays}
PHP:

<pre><code class="language-php">// In php, build an array to pass to the templates
//   \$foo = array('apples', 'pears', 'peaches');

// To set in the template object
\$template->set('foo', \$foo);
</code></pre>
Template:

<pre><code><html><body>
many foo values:
<loop:foo>
 <li><tag:foo />
</loop:foo>
</body></html>
</code></pre>
** Note:** Use a loop tag to go through all foo array elements to pull out all the values of foo. Again the syntax has to be precise or the tags will not be parsed correctly.

\subsection{Arrays With Keys}
PHP:

<pre><code class="language-php">// We now have an array with keys to pass
//   \$foo = array(
//       'city'     => 'paris',
//       'country'  => 'france',
//       'language' => 'french'
//   );

// To set in the template object
\$template->set('foo', \$foo);
</code></pre>
Template:

<pre><code><html><body>
many foo values:
<loop:foo>
 <li><tag:foo.city />, located in <tag:foo.country /> where <tag:foo.language /> is spoken.
</loop:foo>
</body></html>
</code></pre>
** Note:** You must have a loop array to parse through variables with keys. Using the tags \texttt{<tag:foo.somekey />} on their own without the loop tag will not work properly.

\subsection{If Conditions}
PHP:

<pre><code class="language-php">// Set up the php variable, this checks if a user has been authorized
// with the checkUserAuth() function returning a true or false
//   \$is\_auth = checkUserAuth();

// Set the 'if' variable into the template object.
// **** Note that the third parameter is required to tell the template engine that
// the variable will be used in an 'if' test, otherwise the 'if' will \_always\_ return 'true'.
\$template->set('is\_auth', \$is\_auth, true);

// And we set up another variable for inclusion inside the if statement
\$template->set('visitors', countvisits());
</code></pre>
Template:

<pre><code><html><body>
Welcome to our site...<br />
<if:is\_auth>
Today's site statistics are: <tag:visitors /> visitors!
</if:is\_auth>
</body></html>
</code></pre>
** Note:** as always the syntax has to be precise, and the part within the \texttt{<if>...</if>} block will be shown only if \texttt{\$is\_auth} is true.

\subsection{If-Else Conditions}
PHP:

<pre><code class="language-php">\$template->set('somename', true);
</code></pre>
Template:

<pre><code><html><body>
Welcome to our site...<br />
<if:somename>
somename is true

<else:somename>
somename is false
</else:somename>

</if:somename>
</body></html>
</code></pre>
** Note:** The \texttt{<else>} statement must be enclosed in the \texttt{<if>} block.

\subsection{If Conditions and Arrays}
PHP:

<pre><code class="language-php">\$users = array('john', 'peter', 'mary');
\$template->set('users', \$users);
</code></pre>
Template:

<pre><code><html><body>
Welcome to our site...<br />
<if:users>
Current users:<br/>
<loop:users>
 <tag:users /><br/>
</loop:users>

<else:users>
There are no users at the moment
</else:users>

</if:users>
</body></html>
</code></pre>
** Note:** The \texttt{<else>} statement must be enclosed in the \texttt{<if>} block.

\subsection{Nested Loops and Nested Tags}
PHP:

<pre><code class="language-php">\$categories= array(
    array('type' => 'fruit', 'items' => array('apple', 'pear')),
    array('type' => 'veggie', 'items' => array('tomato', 'potato', 'carrot', 'onion')),
    array('type' => 'thing', 'items' => array('spoon', 'paperbag', 'tool'))
);
\$template->set('categories', \$categories);
</code></pre>
Template:

<pre><code><table>
<loop:categories>
 <tr>
  <td>
   I have a <tag:categories.type />. What could it be?
  </td>
  <td>
   <ul>
<loop:categories.items>
    <li><tag:categories.items /></li>
</loop:categories.items>
   </ul>
  </td>
 </tr>
</loop:categories>
</table>
</code></pre>
Output:

<pre><code>I have a fruit. What could it be?
* apple
* pear

I have a veggie. What could it be?
* tomato
* potato
* carrot
* onion

I have a thing. What could it be?
* spoon
* paperbag
* tool
</code></pre>
\end{document}
