Graham Ollis > Mojolicious-Plugin-TtRenderer > Mojolicious::Plugin::TtRenderer::Engine

Download:
Mojolicious-Plugin-TtRenderer-1.53.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.53   Source  

NAME ^

Mojolicious::Plugin::TtRenderer::Engine - Template Toolkit renderer for Mojolicious

VERSION ^

version 1.53

SYNOPSIS ^

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.

DESCRIPTION ^

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.

RENDERING ^

The template file for "example/welcome" would be "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 ^

Helpers are exported automatically under h namespace.

 [% h.url_for('index') %]

METHODS ^

build

This method returns a handler for the Mojolicious renderer.

Supported parameters are

mojo build currently uses a mojo parameter pointing to the base class (Mojo). object. When used the INCLUDE_PATH will be set to
template_options

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.

cache_dir

Absolute or relative dir to your app home, to cache processed versions of your templates. Will default to a temp-dir if not set.

SEE ALSO ^

Mojolicious::Plugin::TtRenderer, Mojolicious, Mojolicious::Guides, http://mojolicious.org.

AUTHOR ^

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

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2014 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.

syntax highlighting: