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.