Mojolicious::Plugin::TtRenderer::Engine - Template Toolkit renderer for Mojolicious
version 1.56
Add the handler:
sub startup { ... # Via mojolicious plugin $self->plugin(tt_renderer => {template_options => {FILTERS => [ ... ]}}); # Or manually use Mojolicious::Plugin::TtRenderer::Engine; my $tt = Mojolicious::Plugin::TtRenderer::Engine->build( mojo => $self, template_options => { PROCESS => 'tpl/wrapper', FILTERS => [ ... ], UNICODE => 1, ENCODING => 'UTF-8', } ); $self->renderer->add_handler( tt => $tt ); }
Template parameter are taken from $c->stash.
$c->stash
See Mojolicious::Plugin::TtRenderer for details on the plugin interface to this module.
This module provides an engine for the rendering of Template Toolkit templates within a Mojolicious context. Templates may be, stored on the local file system, provided inline by the controller or included in the __DATA__ section. Where possible this modules attempts to provide a TT analogue interface to the Perlish templates which come with Mojolicious.
__DATA__
The template file for "example/welcome" would be "templates/welcome.html.tt".
"example/welcome"
"templates/welcome.html.tt"
When template file is not available rendering from __DATA__ is attempted.
__DATA__ @@ welcome.html.tt Welcome, [% user.name %]!
Inline template is also supported:
$self->render(inline => '[% 1 + 1 %]', handler => 'tt');
Helpers are exported automatically under h namespace.
h
[% h.url_for('index') %]
This method returns a handler for the Mojolicious renderer.
Supported parameters are
build
mojo
A hash reference of options that are passed to Template->new(). Note that if you specify an INCLUDE_PATH through this option it will remove the DATA section templates from your path. A better way to specify an INCLUDE_PATH if you also want to use DATA section templates it by manipulating the Mojolicious::Renderer path.
INCLUDE_PATH
Absolute or relative dir to your app home, to cache processed versions of your templates. Will default to a temp-dir if not set.
Mojolicious::Plugin::TtRenderer, Mojolicious, Mojolicious::Guides, http://mojolicious.org.
Original author: Ask Bjørn Hansen
Current maintainer: Graham Ollis <plicease@cpan.org>
Contributors:
vti
Marcus Ramberg
Matthias Bethke
Htbaa
Magnus Holm
Maxim Vuets
Rafael Kitover
giftnuss
Cosimo Streppone
Fayland Lam
Jason Crowther
spleenjack
Árpád Szász
Сергей Романов
uwisser
Dinis Lage
This software is copyright (c) 2015 by Ask Bjørn Hansen.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Mojolicious::Plugin::TtRenderer, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious::Plugin::TtRenderer
CPAN shell
perl -MCPAN -e shell install Mojolicious::Plugin::TtRenderer
For more information on module installation, please visit the detailed CPAN module installation guide.