CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplate - HTML::Template driver to AnyTemplate
This is a driver for CGI::Application::Plugin::AnyTemplate, which provides the implementation details specific to rendering templates via the HTML::Template templating system.
All AnyTemplate drivers are designed to be used the same way. For general usage instructions, see the documentation of CGI::Application::Plugin::AnyTemplate.
AnyTemplate
The HTML::Template syntax for embedding components is:
<TMPL_VAR NAME="cgiapp_embed('some_run_mode', param1, param2, 'literal string3')">
(Support for parameter passing is limited. See the note on paramters below.)
This can be overridden by the following configuration variables:
embed_tag_name # default 'cgiapp_embed'
For instance by setting the following value in your configuration file:
embed_tag_name '***component***'
Then the embedded component tag will look like:
<TMPL_VAR NAME="***component***('some_run_mode')">
Since HTML::Template doesn't support parameter passing in the template, the HTMLTemplate driver emulates this behaviour.
HTMLTemplate
The parameter list passed to the embed subroutine is parsed before the template is parsed. Literal strings (strings enclosed in single or double quotes) are passed verbatim to the target run mode. Params not enclosed in quotes are looked up in $self->param; the resulting literal or looked up values are passed to the target run mode. Finally, the return value of the run mode (its output) is passed as a parameter value to the template.
$self->param
Note that the param lookup scheme is somewhat simplistic. For instance, it does not respect the scope of loops or conditional constructs within the template.
For proper parameter handling using HTML::Template-style templates, use either the CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr or the CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplatePluggable driver instead.
The CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplate driver accepts the following config parameters:
The name of the tag used for embedding components. Defaults to cgiapp_embed.
cgiapp_embed
If auto_add_template_extension is true, then CGI::Application::Plugin::AnyTemplate will append the value of template_extension to filename. By default the template_extension is .html.
auto_add_template_extension
template_extension
filename
.html
This feature is now deprecated and will be removed in a future release.
If this config parameter is true, then CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplate will copy all of the webapp's query params into the template using HTML::Template's associate mechanism:
associate
my $driver = HTML::Template->new( associate => $self->query, );
By default associate_query is false.
associate_query
If you provide an associate config parameter of your own, that will disable the associate_query functionality.
All other configuration parameters are passed on unchanged to HTML::Template.
The required_modules function returns the modules required for this driver to operate. In this case: HTML::Template.
required_modules
Initializes the HTMLTemplate driver. See the docs for CGI::Application::Plugin::AnyTemplate::Base for details.
CGI::Application::Plugin::AnyTemplate::Base
Fills the HTML::Template object with $self->param replacing any magic *embed* tags with the content generated by the appropriate runmodes.
HTML::Template
*embed*
Returns the output of the filled template as a string reference.
See the docs for CGI::Application::Plugin::AnyTemplate::Base for details.
CGI::Application::Plugin::AnyTemplate CGI::Application::Plugin::AnyTemplate::Base CGI::Application::Plugin::AnyTemplate::ComponentHandler CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplatePluggable CGI::Application::Plugin::AnyTemplate::Driver::TemplateToolkit CGI::Application::Plugin::AnyTemplate::Driver::Petal CGI::Application Template::Toolkit HTML::Template HTML::Template::Pluggable HTML::Template::Plugin::Dot Petal Exporter::Renaming CGI::Application::Plugin::TT
Michael Graham, <mgraham@cpan.org>
<mgraham@cpan.org>
Copyright 2005 Michael Graham, All Rights Reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install CGI::Application::Plugin::AnyTemplate, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CGI::Application::Plugin::AnyTemplate
CPAN shell
perl -MCPAN -e shell install CGI::Application::Plugin::AnyTemplate
For more information on module installation, please visit the detailed CPAN module installation guide.