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.

