NAME

MojoX::Renderer::TT - Template Toolkit renderer for Mojo

SYNOPSIS

Add the handler:

        sub startup {
            ...

            # Via mojolicious plugin
            $self->plugin(tt_renderer => {template_options => {FILTERS => [ ... ]}});

            # Or manually
            use MojoX::Renderer::TT;

            my $tt = MojoX::Renderer::TT->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().

AUTHOR

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

TODO

• Better support non-Mojolicious frameworks
• Move the default template cache directory?
• 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 MojoX::Renderer::TT

You can also look for information at:

• git repository

  <http://git.develooper.com/?p=MojoX-Renderer-TT.git;a=summary>, <git://git.develooper.com/MojoX-Renderer-TT.git>

  <http://github.com/abh/mojox-renderer-tt/>

• RT: CPAN's request tracker

  <http://rt.cpan.org/NoAuth/Bugs.html?Dist=MojoX-Renderer-TT>

• CPAN Ratings

  <http://cpanratings.perl.org/d/MojoX-Renderer-TT>

• Search CPAN

  <http://search.cpan.org/dist/MojoX-Renderer-TT/>

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.