MojoX::Renderer::TT(3p)

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 Bjorn 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 <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 <http://git.develooper.com/?p=MojoX-Renderer-TT.git;a=summary>, git://git.develooper.com/MojoX-Renderer-TT.git <git://git.develooper.com/MojoX-Renderer-TT.git>

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

•   RT: CPAN's request tracker

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

•   CPAN Ratings

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

•   Search CPAN

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

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE
Copyright 2008-2010 Ask Bjorn Hansen, all rights reserved.

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