/ 
Mojolicious-Plugin-TtRenderer-1.44
River stage zero No dependents
/ Mojolicious::Plugin::TtRenderer::Engine

NAME

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

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 >.

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 manipulting 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::Engine, Mojolicious, Mojolicious::Guides, http://mojolicious.org.

AUTHOR

Current maintainer: Graham Ollis <plicease@cpan.org>

Original author: Ask Bjørn Hansen, <ask at develooper.com>

BUGS

Please report any bugs or feature requests to the project's github issue tracker https://github.com/abh/mojox-renderer-tt/issues?state=open.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Mojolicious::Plugin::TtRenderer::Engine

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 2008-2010 Ask Bjørn Hansen, all rights reserved.

Copyright 2012 Graham Ollis.

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