/ 
Mojolicious-Plugin-TtRenderer-1.21
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().

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.

AUTHOR

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

TODO

* Better support non-Mojolicious frameworks
* Better way to pass parameters to the templates? (stash)
* More sophisticated default search path?

BUGS

Please report any bugs or feature requests to bug-mojox-renderer-tt at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MojoX-Renderer-TT. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

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

perldoc Mojolicious::Plugin::TtRenderer::Engine

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

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

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