NAME

Mojolicious::Plugin::HTMLTemplateProRenderer - Mojolicious Plugin

SYNOPSIS

  # Mojolicious
  $self->plugin('HTMLTemplateProRenderer');


  # Mojolicious::Lite 
  plugin 'HTMLTemplateProRenderer';

  # Render HTML::Template::Pro handler and post 'utf8 => 1' option for next HTML::Template::Pro->new call
  get '/' => sub{
    my $self = shift;
    $self->render('bender', handler => 'tmpl', tmpl_opts => {utf8 => 1});
  }


  # Set default options for all HTML::Template::Pro->new calls
  plugin 'HTMLTemplateProRenderer', tmpl_opts => {blind_cache => 1, open_mode => '<:encoding(UTF-16)'};

  # Set use of L<HTML::Template::Pro::Extension>
  plugin 'HTMLTemplateProRenderer', tmpl_opts => {use_extension => 1};

  # render inline L<HTML::Template::Pro::Extension> using SLASH_VAR extension
  get '/slash_var' => sub {
    my $self = shift;
    $self->stash(foo => 'bar');
    $self->render(inline => '<p><TMPL_VAR NAME="foo">this will be deleted</TMPL_VAR></p>',
      handler => 'tmpl', plugins => ['SLASH_VAR']);
  };

  # render a loop
  get '/' => sub {
    my $self = shift;
    my $test = [{row => 'First row'},{row => 'Second row'}];
    $self->stash(loop => $test);
    $self->render(inline => '<ul><TMPL_LOOP NAME="loop"><li><TMPL_VAR NAME="row"></li></TMPL_LOOP></ul>',
      handler => 'tmpl');
  };

DESCRIPTION

Mojolicious::Plugin::HTMLTemplateProRenderer is a Mojolicious plugin to use HTML::Template::Pro and HTML::Template::Pro::Extension modules in your Mojo projects.

HTML::Template::Pro is a fast lightweight C/Perl+XS reimplementation of HTML::Template (as of 2.9) and HTML::Template::Expr (as of 0.0.7). It is not intended to be a complete replacement, but to be a fast implementation of HTML::Template if you don't need querying, the extended facility of HTML::Template.

Designed for heavy upload, resource limitations, abcence of mod_perl.

HTML::Template::Pro::Extension is a pluggable extension syntax module for HTML::Template::Pro.

METHODS

Mojolicious::Plugin::HTMLTemplateProRenderer inherits all methods from Mojolicious::Plugin and implements the following new ones.

register

  $plugin->register;

Register plugin in Mojolicious application.

OPTIONS

These are options for Mojolicious::Plugin::HTMLTemplateProRenderer

use_home_template

  $self->render('template', handler => 'tmpl',use_home_template => 1);

Templates are found starting from home base app path other than home_app/templates path.

use_extension

  $self->render('template', handler => 'tmpl',use_extension => 1, plugins => ['SLASH_VAR']

Enable use of HTML::Template::Pro::Extension and use of plugins.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.

COPYRIGHT & LICENSE

Copyright 2014 Emiliano Bruni, all rights reserved.

Initially based on Mojolicious::Plugin::HTMLTemplateRenderer code which is copyrighted by Bob Faist.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.