NAME

HTML::SimpleTemplate - Quick and simple template library for Perl

PREREQUISITES

Symbol package - should already be in your Perl installation

INSTALL

perl Makefile.PL; make; make install; make test

HISTORY

Was previously known as WWW::Template and not distributed on CPAN; however quite a few people are using it. If you are an ex-WWW-Templater, be aware that 1. prefixes are GONE (all they ever did was append a directory name to the template filename and you can just as easily do that yourself) and 2. I really, really, really have fixed the nested if logic this time. I know you've heard that before... :) 3. At last, you don't need to edit the module itself to change the template path - you can specify it when you create a SimpleTemplate object.

COPYRIGHT

May be used and distributed under the same terms as Perl itself.

SYNOPSIS

use HTML::SimpleTemplate;

      # A template object referencing a particular directory
      my $adminpages=new HTML::SimpleTemplate("/templates/admin");

      # A template object referencing files in this directory
      my $localpages=new HTML::SimpleTemplate;

      # Display this template file, passing no parameters
      $localpages->Display("welcome.tpl");

      # Display this template file, passing the %account hash
      $localpages->Display("account.tpl",\%account);

      # Display this template file, with a-la-carte parameter
      $localpages->Display("order.tpl",{product=>"Perl mug"});

DESCRIPTION
DISPLAY METHOD

Display($file,[\%variables]);

The Display method parses the specified file according to the rules specified below. It can optionally be passed a second parameter, a reference to a hash, containing the variables used in the template.

When the SimpleTemplate object is created a template path can optionally be specified. If this is absent filenames specified to Display are relative to the current directory.

TEMPLATE SYNTAX

            Hello $name!
            ?($name eq "George")
            ?$rude
            ..you old fool!
            ?end
            It's too late at night to think of witty examples!
            ?end

A template is a text file which may contain certain variable references and special commands. Variables are referenced by prefixing their name with the dollar symbol, as in Perl itself. Variable names must be alphanumeric, and must be followed by a non-alphanumeric character (including spaces and newlines) so the module knows where the name ends.

There area very small number of special commands, which all involve either a ? or an ! in the first column of the line.

CONDITIONALS

            ?$SomeVariable
            The variable evaluated as true
            ?else
            No it didn't
            ?end

            ?($Any=~/perl evaluation that doesn't contain brackets/)
            It was
            ?else
            It wasn't (else is optional by the way!)
            ?end

You may nest conditionals to your hearts content, but the layout makes it confusing if you have more than two or three. Anyway that kind of complex logic belongs in Perl, not in HTML.

INCLUDES

!header.tpl

!common/header.tpl

!errors/$ErrorType.tpl

When you include another template all of the variables in your current template remain available.

CALLBACKS

&InsertContent($fish)

Yes, you can call Perl inside your template. You can, of course, then call templates from inside that Perl. Very powerful, potentially very confusing...

COMMENTS

Saving the best for last, you can now put sensible comments in your HTML - and the page viewer doesn't get to see it!

            # This section for stupid people only
            ?NameError
            It appears you have failed to enter your name.
            # You freakin' numbskull!
            ?end

NOTES

Clearly you cannot embed conditionals, callbacks etc in the middle of a line. You also can't have any plain content following a command. However, for HTML, which this is primarily designed for, that just isn't an issue.

By the way, if you're creating an HTML page, it works quite nicely to put that Content-type: text/html in the template if it makes you happy having it there.

AUTHOR

A Crawford, acrawford@ieee.org

SEE ALSO

HTML::Template